From Fedora Project Wiki

Revision as of 21:31, 25 June 2010 by Jjmcd (talk | contribs)

This page needs some love
This page should be revised or reconstructed to be more helpful. Problems may include being out of step with current team or project status or process.
DocsProject Header docTeam1.png

Docs Projects

Most of the effort undertaken by the Docs Project is oriented towards producing formal documents. Usually, these are DocBook XML documents rendered in a number of formats using Publican.

In some cases, a draft is produced on the wiki, or content from various subject matter experts is collected on the wiki. In some cases, writers collect data (or perhaps have the expertise or otherwise do research) and write directly to XML.

Documents usually end up being published to although often they are also packaged and made available through the Fedora repositories.



The Docs Project often works with marketing to produce announcements. This work tends to be done almost entirely within the wiki, and rarely, if ever is a formal document produced. Occasionally, the Fedora Design Team will take the wiki document and use it as the basis for a glossy document or brochure. A similar process, obviously without the engagement of Marketing, is used when documenting Docs Project procedures or policies.


Release Notes

Release notes, on the other hand, almost always follow the complete process. The only unexploited path is directly writing to DocBook; Release Notes are always developed in the wiki first.



Guides are typically not developed in the wiki but rather written straight to DocBook. In addition, Guides are typically not packaged. The emphasis here is on typical, Guides are sometimes packaged and there is no reason input cannot be collected on the wiki.


Access Control

Each of the various repositories has access controlled by some FAS group. Access to the wiki is encouraged, rather than controlled, so access to the wiki is available to anyone who has signed the contributor agreement.

Contributors who have learned to write XML and become familiar with git are entered into the Docs writers group, allowing access to the git repositories. Each document is maintained in a git repository, and the writer group grants access to all of these.

When a contributor has developed the skills necessary to prepare documents for docs.fp.o he is given entry to the publisher's group, which permits committing changes to the Fedora documentation website. If a contributor needs to package a document, the packaged document is submitted for review, and once successfully reviewed, the contributor gets packager privilege, and may push that package to the Fedora repositories.


Note: Source

The sources for the above images are text:

If you wish to edit the above images, install the Package-x-generic-16.pnggraphiz package and save the text on one of the above pages to a text file. Then execute the command:

  dot -Tpng -o TLflow2.png

(or whichever file you select). Edit the source and repeat until the image is how you desire. Note that the various flow- files are copies of TLflow2 with various sections grayed and the size reduced. Then update the source wiki page for those following you, and upload the png to the wiki. Refresh this page and be sure it appears in context correctly.

Old Material still to be incorporated

Out of date
Much of the material below is badly out of date or in need of considerable editing. It has been commented out for now.