CONTRIBUTING, SECURITY, docs/ARCHITECTURE und docs/FILE_FORMAT sind jetzt englisch; die deutschen Fassungen bleiben als *.de.md erhalten und verlinken sich gegenseitig. Inhaltlich nachgezogen: Live-Strich mit gleicher Tessellierung, runde Ecken, Nachgleiten, eingerasteter Textmarker, Farben im Dateiformat sind sRGB. Kommentare im Flatpak-Manifest auf Englisch. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
Contributing to ink-notes
English · Deutsch
Thank you for wanting to improve ink-notes!
Where?
The main repository is on Gitea: https://gitea.pansi.eu/harald/ink-notes. GitHub is a mirror – issues and pull requests are welcome there too, but pull requests are applied to Gitea by hand.
Reporting bugs and suggesting ideas
- Please check first whether there is already an issue for it.
- For bugs, use the "Bug report" template: version (☰ → Updates), distribution, Wayland or X11, input device (pen, finger, mouse, touchpad) and the steps that trigger the bug. A screenshot or a short recording often helps a lot.
- English and German are both fine.
- Please do not report security vulnerabilities publicly; follow SECURITY.md instead.
Contributing code
- Discuss larger changes in an issue first.
- Build and test as described in the README. These checks must pass before submitting (CI checks them too):
cargo fmt --check cargo clippy --all-targets -- -D warnings cargo test - New features and bug fixes get a test where that makes sense.
- Document changes to the file format in docs/FILE_FORMAT.md (and its German version); older notebooks must remain readable.
- Commit messages follow Conventional Commits, e.g.
fix: …,feat: …,perf: …,docs: …; refer to an issue as(Issue #28). Code comments and commit messages in this project are written in German. - The interface is available in German and English: write new texts with
t!("…")(the German text is the key) and add the English translation insrc/i18n/.
By contributing you agree that your contribution is licensed under the project's MIT License. Everyone taking part is expected to follow the Code of Conduct.