Differences
This shows you the differences between two versions of the page.
| Next revisionBoth sides next revision |
| documentation [2010/11/06 10:48] – created 188.7.26.125 | documentation [2010/11/07 09:49] – updated writers section mike |
|---|
| ===== Generalities ===== | ===== Generalities ===== |
| |
| The Xfce documentation project is available online at [[http://git.xfce.org/|git.xfce.org]] in the "''xfce4-docs''" repository that is made up of as many branches as different documentations. For example, the Xfce Panel documentation is held in the branch ''xfce4-panel-master''. On another hand, the ''master'' branch contains the Xfce user guide, a general documentation | The documentation is available online at [[http://git.xfce.org/|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 [[http://projectmallard.org/|Mallard]] markup language. | The documentation is written with the [[http://projectmallard.org/|Mallard]] markup language. |
| ===== Writers ===== | ===== Writers ===== |
| |
| * Who is behind / The team | To discuss the Xfce documentation project you have to join the mailing-list [[http://foo-projects.org/mailman/listinfo/xfce4-dev|xfce4-dev]]. When sending messages to the list simply make it clear in the subject of your message that it concerns the documentation. |
| * Guidelines | |
| * Template | For people new and interested into writing documentation, there is a [[http://library.gnome.org/devel/gdp-handbook/stable/index.html.en|complete handbook]] written by the [[http://live.gnome.org/DocumentationProject|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 |
| |
| ===== Translators ===== | ===== Translators ===== |