(Commenting out the contributing roles and removing the __NOTOC__) |
(→What we are working on now.: Lowercasing section titles; changing 'bug tickets' to 'task list' to make it clearer to the new contributor.) |
||
| Line 38: | Line 38: | ||
== What we are working on now. == | == What we are working on now. == | ||
=== Draft and | === Draft and informal documentation === | ||
The [http://fedoraproject.org/wiki Fedora Wiki] is used to create [[:Category:Draft_Documentation | draft versions]] of documentation and also provides a place for [[:Category:Documentation | non-formal documentation]]. | The [http://fedoraproject.org/wiki Fedora Wiki] is used to create [[:Category:Draft_Documentation | draft versions]] of documentation and also provides a place for [[:Category:Documentation | non-formal documentation]]. | ||
=== Formal | === Formal documentation === | ||
All [[Docs_Project_guides | formal documentation]] is located at [http://docs.fedoraproject.org http://docs.fedoraproject.org]. These guides are written in [[DocBook]] XML and compiled using [[Publican]]. | All [[Docs_Project_guides | formal documentation]] is located at [http://docs.fedoraproject.org http://docs.fedoraproject.org]. These guides are written in [[DocBook]] XML and compiled using [[Publican]]. | ||
| Line 54: | Line 54: | ||
* Amateur Radio Guide | * Amateur Radio Guide | ||
=== | === Task list === | ||
We use [http://bugzilla.redhat.com 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. | We use [http://bugzilla.redhat.com 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. | ||
Revision as of 19:04, 17 December 2009
The Fedora Documentation Project creates, publishes, and maintains the software documentation for the Fedora operating system.
Mission Statement
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.
- 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 :
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 .
Subcategories
This category has the following 19 subcategories, out of 19 total.
D
- Docs Project archives
- Docs Project content tasks for experienced contributors
- Docs Project content tasks for new contributors
- Docs Project DE
- Docs Project meetings
- Docs Project meetings/cs
- Docs Project process
- Docs Project tasks
- Documentation
- Documentation beats
- Documentation CMS Option
- Documentation tools
- Draft documentation
Pages in category "Docs Project"
The following 143 pages are in this category, out of 143 total.
*
D
- Desktop Documentation Presentation Options
- Desktop Documentation Presentation Options-Example-desktop
- Desktop Documentation Presentation Options-Example-index
- Desktop Documentation Presentation Options-Example-omf
- Desktop Documentation Presentation Options-Example-spec
- Template:Docs beat closed
- Template:Docs beat converted
- Template:Docs beat open
- Docs FAD 2014
- Meeting:Docs IRC log 20090225
- Meeting:Docs IRC log 20090319
- Docs packages
- Docs Project 14 Release Announcement
- Docs Project admin notes
- Docs Project Focus
- Docs Project guide goals for F14
- Docs Project guide goals for F15
- Docs Project guide goals for F16
- Docs Project IRC channel standard topic
- Docs Project licensing FAQ
- Docs Project licensing FAQ/es
- Docs Project meetings
- Docs Project meetings/cs
- Docs Project mentors
- Docs Project mentors/cs
- Docs Project mission
- Docs Project mission statement
- Docs Project mission statement/cs
- Docs Project mission statement/de
- Docs Project mission statement/es
- Archive:Docs Project Style Guide - Word usage, capitalization, and spelling
- Docs publishers in Koji
- Docs QA
- Docs welcome email
- Docs Workflow-Discussion
- Documentation Amateur Radio Beat
- Documentation Architecture Specific Content Beat
- Documentation Architecture Specific Content Beats
- Documentation ARM Specific Content Beat
- Documentation Backwards Compatibility Beat
- Documentation Beat status
- Documentation Beats Feedback
- Documentation Beats Hardware Overview
- Documentation Beats Installer
- Documentation Beats Overview
- Documentation Beats Welcome
- Documentation Big Data Beat
- Documentation Boot Beat
- Documentation Circuit Design Beat
- Documentation Cloud Beat
- Documentation Cloud Specific Content Beat
- Documentation Cluster Beat
- Documentation Container Beat
- Documentation Database Servers Beat
- Documentation Desktop Beat
- Documentation Development Beat
- Documentation Development D Beat
- Documentation Development Eclipse Beat
- Documentation Development GCC Tools Beat
- Documentation Development Haskell Beat
- Documentation Development OCaml Beat
- Documentation Development Runtime Beat
- Documentation Development Tools Beat
- Documentation Development Web Beat
- Documentation EDA Beat
- Documentation Embedded Development Beat
- Documentation Entertainment Beat
- Documentation Fedora.next Beat
- Documentation File Servers Beat
- Documentation File Systems Beat
- Documentation hosted at Fedora Hosted
- Documentation I18n Beat
- Documentation Installer Beat
- Documentation Java Beat
- Documentation Kernel Beat
- Documentation Legal Beat
- Documentation Live Image Beat
- Documentation Mail Servers Beat
- Documentation Monitoring Beat
- Documentation Multimedia Beat
- Documentation Musicians Beat
- Documentation Networking Beat
- Documentation Printing Beat
- Documentation Productivity Beat
- Documentation Robotics Beat
- Documentation Samba Beat
- Documentation Scientific and Technical Beat
- Documentation Scientific and Technical BeatDocumentation EDA Beat
- Documentation Security Beat
- Documentation Server Configuration Tools Beat
- Documentation Server Specific Content Beat
- Documentation System Daemons Beat
- Documentation Virtualization Beat
- Documentation Web Servers Beat
- Documentation Workstation Specific Content Beat
- Documentation x86 64 Specific Beat
- Documentation x86 Specific Content Beat
- Documentation Xorg Beat