cleanup

HACKING.md

@@ -0,0 +1,82 @@
+# Hacking on deb-bootc-image-builder
+
+This document provides information for developers who want to contribute to deb-bootc-image-builder.
+
+## Development Environment
+
+### Prerequisites
+
+- Go 1.21 or later
+- Python 3.8+ (for testing)
+- Docker or Podman
+- Make
+
+### Building
+
+```bash
+# Build the binary
+make build-binary
+
+# Build the container
+make build-container
+
+# Run tests
+make test
+```
+
+### Testing
+
+```bash
+# Run all tests
+make test
+
+# Run specific test categories
+pytest test/unit/
+pytest test/integration/
+pytest test/performance/
+
+# Run with FMF
+fmf run --all
+```
+
+## Project Structure
+
+This project follows the standard osbuild repository structure:
+
+- **`bib/`** - Main Go application
+- **`test/`** - Test files and utilities
+- **`scripts/`** - Utility scripts organized by function
+- **`docs/`** - Project documentation
+- **`.fmf/`** - FMF testing framework
+
+## Code Style
+
+### Go Code
+- Follow Go standard formatting (`go fmt`)
+- Use `golangci-lint` for linting
+- Follow Go naming conventions
+- Include proper error handling
+
+### Python Code
+- Follow PEP 8 style guidelines
+- Use type hints where appropriate
+- Include docstrings for functions and classes
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass
+6. Submit a pull request
+
+## Getting Help
+
+- **GitHub Issues**: For bug reports and feature requests
+- **GitHub Discussions**: For questions and general discussion
+- **Matrix**: Join #image-builder on fedoraproject.org
+
+## License
+
+This project is licensed under the Apache License, Version 2.0.