The reference for working on the Linux app. Start with ARCHITECTURE.md for the crate graph and CONTRIBUTING.md for the build; ROADMAP.md says what is built and what is not.
| Guide | What it covers |
|---|---|
| adding-drivers.md | Adding an engine as a crate: the client library, capabilities, Connection, writes and editor sessions |
| error-handling.md | The error types each layer returns, their categories, and the text and logs the app makes of them |
| state-management.md | Where the application, window, workspace and tab state lives, and the rules every view follows |
| storage.md | Which store holds which data: files, GSettings, the Secret Service and SQLite |
| testing.md | The test suites, the conformance and Docker tests, and the CI workflows |
| troubleshooting.md | For users: saved passwords, SSH, Kerberos, logs, crash reports, bug reports and downgrades |
| regression-tests.md | The tests that guard each critical audit finding |
| releasing.md | The setup before the first release, a release, a packaging fix and a fix release |
| po/README.md | Marking strings for translation and generating the template |
The architecture decision records, with a summary of each, are indexed in decisions/README.md.