- Remove vague TODO comment, clarify legacy SHA256 support purpose - Make CONTRIBUTING.md more generic (not GitHub-specific) - Remove Git from prerequisites (only needed if cloning)
1.4 KiB
1.4 KiB
Contributing to PassAGE
Thank you for your interest in contributing to PassAGE!
Getting Started
- Fork the repository (if using a forge like Gitea)
- Clone the repository locally
- Create a branch for your changes
- Make your changes and test them
- Submit a merge request or push your changes
Development Setup
-
Fork and clone the repository:
git clone <repository-url> cd PassAGE -
Install dependencies:
go mod download -
Build the project:
make build # or go build -o passage . -
Run tests:
make test # or go test ./...
Code Style
- Follow standard Go formatting (
go fmt) - Run
go vetbefore committing - Use meaningful variable and function names
- Add comments for non-obvious code
Testing
- Write tests for new features
- Ensure all tests pass:
go test ./... - Test with race detector:
make test-race
Submitting Changes
- Create a branch for your changes
- Make your changes
- Ensure code compiles and tests pass
- Submit a pull request with a clear description
Building Manpages
If you modify documentation, rebuild the manpage:
make man
Requires pandoc or go-md2man to be installed.
Questions?
Feel free to open an issue or start a discussion in the repository.