Skip to content

Contributing

ChristianHandy edited this page Nov 17, 2026 · 2 revisions

Contributing

FleetPilot needs testers, translators, reviewers and developers. No homelab needed: the live demo and the demo lab emulate the machines.

Ways to help

Your first pull request

  1. Fork the repository and create a branch from main.
  2. Set up and run the checks:
    pip install --require-hashes -r requirements-lock.txt -r requirements-dev-lock.txt
    python -m coverage run -m pytest -q && python -m coverage report && ruff check .
  3. Add tests (in tests/) and a line in CHANGELOG.md under Unreleased if users notice the change.
  4. Sign off every commit: git commit -s (DCO).
  5. Open the pull request and fill in the template, including the AI assistance section.

What checks your pull request

Check Passes when
pytest (3.11, 3.12, 3.13) Tests pass, coverage doesn't drop, at least 70 % of changed lines are tested, no vulnerable dependency
Safe to merge Install-and-use test, Android build, virus and backdoor scan, ShellCheck, changelog entry, no new untranslated German text
AI assistance The code is written by people: no declared AI help, no strong AI style signals, no AI leftovers
Analyze (python) CodeQL finds nothing new

A summary comment on the pull request says what fails and how to fix it. Using AI to learn or to understand the code is fine; the code you submit should be your own. Say honestly in the AI assistance section what you used: a maintainer can allow a pull request after review.

Everything in detail: CONTRIBUTING.md · Code of conduct

Clone this wiki locally