Contributing

We welcome contributions — bug reports, fixes, new features, and documentation improvements.

How to Contribute

All contributions to this repository must be signed as described in the Developer Certificate of Origin. Your signature certifies that you wrote the contribution or have the right to pass it on as an open source contribution.

Report a Bug or Request a Feature

Open a new issue — it's that easy.

Submit a Fix or Feature

1. Fork the repository
2. Create a feature branch from master
3. Write your change with tests where applicable
4. Follow the test naming convention: [MethodUnderTest]_[Scenario]_[ExpectedBehavior]
5. Open a pull request against master

Development Setup

# Restore dependencies
dotnet restore vHC/HC.sln

# Build (debug)
dotnet build vHC/HC.sln --configuration Debug

# Run tests (Windows only — requires WPF/.NET Windows)
dotnet test vHC/VhcXTests/VhcXTests.csproj

Note

Tests require Windows due to WPF dependencies. Non-Windows builds skip test compilation.

Commit Convention

Use Conventional Commits — feat:, fix:, chore:, ci:, test:, docs:. Feature commits (feat:) appear in the auto-generated Feature Timeline.

License

By contributing, you agree that your contributions will be licensed under the project's MIT License.