From Fedora Project Wiki
(Created page with '== Become a docs project contributor == Before contributing to the [http://fedoraproject.org/wiki/DocsProject Docs Project] ask yourself [http://fedoraproject.org/wiki/Join_the_...') |
|||
Line 23: | Line 23: | ||
== Pointers for contributors looking for documents to write == | == Pointers for contributors looking for documents to write == | ||
* Pick something from [https://fedoraproject.org/wiki/Category:Docs_Project_tasks the general task list] or [https://fedoraproject.org/wiki/Docs_Project_admin_tasks_for_experienced_contributors#Task_table the more advanced contributors']. | |||
* Check out the [https://fedoraproject.org/wiki/Docs_Project_meetings#Guides guides table] and find a documentation buddy. | |||
The wiki itself needs to be gardened. Check out the [https://fedoraproject.org/wiki/Category:Pages_that_need_love pages that need love index.] | * The wiki itself needs to be gardened. Check out the [https://fedoraproject.org/wiki/Category:Pages_that_need_love pages that need love index]. | ||
* [https://bugzilla.redhat.com/buglist.cgi?query_format=advanced&order=Importance&bug_status=NEW&bug_status=ASSIGNED&classification=Fedora&product=Fedora%20Documentation Go bug hunting.] | |||
Have some other crazy idea? Great! Let's discuss it at the [https://fedoraproject.org/wiki/Docs_Project_meetings next meeting. | * Have some other crazy idea? Great! Let's discuss it at the [https://fedoraproject.org/wiki/Docs_Project_meetings next meeting]. |
Revision as of 01:30, 18 June 2010
Become a docs project contributor
Before contributing to the Docs Project ask yourself if you want to join the docs project. The bare minimum you will need is a Fedora Access System account (FAS) Fedora Contributor License Agreement (CLA).
On Licensing / Copyrights
This wiki is under Creative Commons Attribution-Share Alike 3.0 Unported License (see [FedoraProject:Copyrights FedoraProject:Copyrights for details).
Document formatting
The format depends on the type of document the contributor is writing.
- The website is in HTML.
- The guides are developed in XML and converted to HTML and .pdf
- Fedora uses Mediawiki and uses Mediawiki syntax for the wiki pages.
Suggested Tools
- Gobby is a great real-time documentation collaboration service.
- Publican is a graphical user interface for developing xml files and converting them into other formats.
- Works not directly saved into the wiki should be saved in git via Fedora Hosted.
Pointers for contributors looking for documents to write
- Pick something from the general task list or the more advanced contributors'.
- Check out the guides table and find a documentation buddy.
- The wiki itself needs to be gardened. Check out the pages that need love index.
- Go bug hunting.
- Have some other crazy idea? Great! Let's discuss it at the next meeting.