This is an old revision of the document!
This page describes the Xfce documentation project as well as how documentation works for writers, translators and developers.
NB: this page is a work in progress
The documentation is available online at git.xfce.org in the xfce4-docs repository. The master branch contains the Xfce User Guide, a general documentation for the Xfce desktop. Furthermore this repository is made up of one branch per documentation, for example the Xfce Panel documentation is held in the branch xfce4-panel-master.
The documentation is written with the Mallard markup language.
Translation is done on Transifex at translations.xfce.org as individual PO files.
To discuss the Xfce documentation project you have to join the mailing-list xfce4-dev. When sending messages to the list simply make it clear in the subject of your message that it concerns the documentation.
For people new and interested into writing documentation, there is a complete handbook written by the GNOME Documentation Project. It contains useful information on how to present the content, categorize the sections or the overall tone to keep inside a documentation. However since the Xfce documentation is written in Mallard markup language, the sections concerning Docbook are insignificant.
Retrieving and creating documentation
- how to download the xfce4-docs repo
- how to checkout a documentation
- how to create a new documentation
NB: we probably should wait til Tx 1.0 gets installed.
- How to add .gitmodules
- How to use the latest xdt-autogen with XDT_AUTOGEN_CHECK_DOCS