Contributing

Getting started

Install the .NET 10 SDK. The repository's global.json selects the supported SDK feature bands.

From the repository root:

dotnet build DatabaseManager.slnx
dotnet test --solution solutions/UnitTests.slnx
dotnet format --severity info --verify-no-changes

See integration tests for Docker-backed test infrastructure, releases for the release process, and the development tools for Entity Framework code generation. If you have Docker installed, you can also run the integration test suite:

dotnet test --solution solutions/IntegrationTest.slnx

Package consumers should use the library guide rather than these contributor instructions.

Feedback and Pull Requests

Bugs and feature requests can be logged on GitHub. However, the "source of truth" for this project is IssueTracker. You can log in via your GitHub account and you should be able to create work items.

If you would like to actively contribute to implementing features or fixing bugs, reach out and I can upgrade your permissions on IssueTracker.

See the repository contribution checklist before opening a pull request.

Documentation

Create a Python virtual environment and install the pinned documentation tools:

python3 -m venv .venv

On Linux/macOS, activate it with source .venv/bin/activate; in Windows PowerShell, use .venv\Scripts\Activate.ps1. Then run:

python -m pip install -r requirements-docs.txt
mkdocs build --strict
mkdocs serve

The preview runs at http://127.0.0.1:8000/database-manager/.

With Node.js 24 installed, run the release-policy regression tests locally:

node --test .github/scripts/docs-release.test.cjs