Good documentation is difficult to keep up-to-date. If you find a typo or an error in the documentation please let us know — ideally, by submitting a patch with your correction.

Writing

The documentation on the website is not freely editable. The way we document things has serious security implications. People should be able to trust the Tails website as much as they trust Tails itself. Furthermore, every change in the documentation possibly breaks the translations that were made of the previous version.

But there are still many ways you can start contributing:

• We maintain a list of documentation tasks. You can start writing a draft in the corresponding ticket and then ask us for review.

• Small fixes and enhancements to the current documentation are greatly welcome. This can be done by sending us Git patches, by publishing a Git branch, or simply by email on the public mailing list. In the general case, this work should be based on the master branch.

Documentation writers coordinate themselves using our usual development communication channels.

Documentation writers should also read our documentation guidelines.

We recommend you to build an offline version of the documentation to test your contributions before sharing them with us.

Translating

We want Tails end-user documentation to be translated in as many languages as possible. See the guidelines for translators for details.

Talk to us

If you want to talk in public with other Tails developers and users:

• You can subscribe or write to the tails-dev@boum.org mailing-list. Any message sent to this list is stored in a public archive, so beware of what your email content and headers reveal about yourself: location, IP address, etc.
• You can join our #tails and #tails-dev chatrooms; note: only a few Tails core developers hang out there, so email is preferred for anything that might be of interest for the larger Tails development community.
• For translation-related matters, you can subscribe or write to the tails-l10n@boum.org mailing-list. Any message sent to this list is stored in a public archive, so beware of what your email content and headers reveal about yourself: location, IP address, etc.
• For user experience and user interface related matters, you can subscribe or write to the tails-ux@boum.org mailing-list. Any message sent to this list is stored in a public archive, so beware of what your email content and headers reveal about yourself: location, IP address, etc.

For matters that need to be hidden from the public eyes, email the private development mailing list: tails@boum.org. To achieve end-to-end encryption, encrypt such email with our OpenPGP key.