From Fedora Project Wiki

(Moving mission statement up.)
(→‎Communication Channels: Added Fedora Talk.)
Line 31: Line 31:
* '''Mailing List:''' For formal discussions, the Fedora Documentation Project uses the [https://www.redhat.com/mailman/listinfo/fedora-docs-list fedora-docs] mailing list.
* '''Mailing List:''' For formal discussions, the Fedora Documentation Project uses the [https://www.redhat.com/mailman/listinfo/fedora-docs-list fedora-docs] mailing list.
* '''IRC:''' For informal discussions about Fedora Documentation, many members of the project frequent the '''#fedora-docs''' channel on '''irc.freenode.net'''.
* '''IRC:''' For informal discussions about Fedora Documentation, many members of the project frequent the '''#fedora-docs''' channel on '''irc.freenode.net'''.
* '''Talk:''' For project discussions we sometimes use the [[Fedora Talk]] VoIP system.  Our conference room is ''2008''.
* '''Meetings:''' Weekly Fedora Documentation Project meetings are held on Thursdays at 0001 UTC, in the '''#fedora-meeting''' channel on '''irc.freenode.net'''. Check out the [[Docs_Project_meetings| Meetings]] wiki page for past meetings minutes, and the agenda for the upcoming meeting.
* '''Meetings:''' Weekly Fedora Documentation Project meetings are held on Thursdays at 0001 UTC, in the '''#fedora-meeting''' channel on '''irc.freenode.net'''. Check out the [[Docs_Project_meetings| Meetings]] wiki page for past meetings minutes, and the agenda for the upcoming meeting.



Revision as of 19:17, 17 December 2009

The mission of Fedora's Documentation Project is to improve the overall experience of Fedora users and contributors by providing documentation. We explain how to use certain software and systems, provide written accounts of special events (like releases), and recommend settings for software and systems (in terms of security, performance, and other concerns). In pursuing this work, the Docs Project creates and uses only free and open-source software, content, tools, and processes, so our documentation is reusable, modifiable, and rebuildable by anyone, for free, forever.



Communication Channels

  • Mailing List: For formal discussions, the Fedora Documentation Project uses the fedora-docs mailing list.
  • IRC: For informal discussions about Fedora Documentation, many members of the project frequent the #fedora-docs channel on irc.freenode.net.
  • Talk: For project discussions we sometimes use the Fedora Talk VoIP system. Our conference room is 2008.
  • Meetings: Weekly Fedora Documentation Project meetings are held on Thursdays at 0001 UTC, in the #fedora-meeting channel on irc.freenode.net. Check out the Meetings wiki page for past meetings minutes, and the agenda for the upcoming meeting.

How we do it.

Documents typically begin life on the Fedora wiki. This is to aid the development of the document until it can be finalized. Unfinished documents are categorized as Category:Draft_Documentation. Once the document is deemed complete, the Draft_Documentation category is replaced by the Category:Documentation category.

If the documentation is deemed to be "official" and in need of a more permanent home, the wiki pages are translated into Docbook XML of which can then be used to generate HTML and RPM files that are used to disseminate to the public. HTML files are published at http://docs.fedoraproject.org and RPM files are published in the Fedora repository.

What we are working on now.

Draft and informal documentation

The Fedora Wiki is used to create draft versions of documentation and also provides a place for non-formal documentation.

Formal documentation

All formal documentation is located at http://docs.fedoraproject.org. These guides are written in DocBook XML and compiled using Publican.

We are working on a number of guides that aid users in setting up and using Fedora:

  • Installation Guide
  • Release Notes
  • Security Guide
  • SELinux Guide
  • User Guide
  • Deployment Guide
  • RPM Guide
  • Amateur Radio Guide

Task list

We use Red Hat's Bugzilla instance for tracking issues and tasks within the Docs Project. It is always helpful to provide input and patches to bugs.

You can query Bugzilla or use one of the following links to find tickets that are open:

Documentation Licensing

All documentation produced by Fedora is released under the Creative Commons Attribution-Share Alike License 3.0 Unported License :

Legal/Licenses#Documentation

Miscellanea

The following pages collect notes, hints, and other bric-a-brac that would otherwise be lost to the vagaries of the list archive's "search" function.

Check the FAQ on this wiki for general information on Fedora and links to other resources.

Stuff

The central project workflow page is DocsProject/WorkFlow .

Pages in category "Docs Project"

The following 146 pages are in this category, out of 146 total.

D