First, thank you for being interested in contributing to the Debian Administrator’s Handbook. This book is a free, open source project driven by its original authors — Raphaël Hertzog and Roland Mas. As such, your contributions are greatly welcome.
Translate the book
This is certainly the best way to help. By contributing a new translation or completing/improving an existing one, you’re helping to make the book available to even more people than today.
Download the Git repository:
$ git clone https://salsa.debian.org/hertzog/debian-handbook.git
Now have a look at the README.translators file to learn more about the work it involves. Join the mailing list dedicated to coordination with translators, don’t hesitate to ask questions there.
The following translations have started:
- Arabic (ar-MA)
- Brazilian Portuguese (pt-BR)
- Simplified Chinese (zh-CN)
- Traditional Chinese (zh-TW)
- Catalan (ca-ES)
- Croatian (hr-HR)
- Czech (cs-CZ)
- Farsi (Persian) (fa-IR)
- French (fr-FR)
- Danish (da-DK)
- Dutch (nl-NL)
- German (de-DE)
- Greek (el-GR)
- Indonesian (id-ID)
- Italian (it-IT)
- Japanese (ja-JP)
- Korean (ko-KR)
- Norwegian Bokmål (nb-NO)
- Polish (pl-PL)
- Romanian (ro-RO)
- Russian (ru-RU)
- Spanish (es-ES)
- Swedish (sv-SE)
- Turkish (tr-TR)
- Vietnamese (vi-VN)
Contribute fixes
If you want to fix something in the book, feel free to fork the repository on salsa.debian.org and then open a merge request to send us your changes. Alternatively you can send us a plain patch in a new bug report against the debian-handbook package (use “reportbug debian-handbook” on a Debian system).
You can also have a look at the list of open bugs and prepare patches. You can also use the package tracker to subscribe to the bug emails.
Before reporting typos, please verify if they haven’t been already fixed. You can look in the sources (ideal) or on the online copy auto-built out of git.
Report errors and suggest improvements
Your feedback as reader is certainly welcome. We prefer if you report us errors and suggestions via GitLab issues on the salsa project. But you can also send bug reports against the debian-handbook package.
Donate
If you don’t have the skills or the time required to contribute some work, we gladly accept donations. They allow us to spend the time required to update the book for each Debian release and to improve it with new content.
To make a donation, please use the form on the download page.