From Fedora Project Wiki
m (added autolang template) |
(Hm, this step doesn't work if the new person's not CLA+1) |
||
| Line 21: | Line 21: | ||
* [https://fedoraproject.org/wiki/Publican Publican] is a graphical user interface for developing xml files and converting them into other formats. | * [https://fedoraproject.org/wiki/Publican 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 [https://fedorahosted.org/ Fedora Hosted]. | * Works not directly saved into the wiki should be saved in git via [https://fedorahosted.org/ Fedora Hosted]. | ||
<!-- This next step only works if the person is CLA+1 -- i.e. they have to be part of a group. That's not referenced anywhere in our join docs that I can see -- should it be? | |||
* You may use your [https://fedoraproject.org/wiki/EmailAliases fedoraproject.org email alias] which is granted to you upon successful [https://fedoraproject.org/wiki/Docs_Project_contributor_expectations#Become_a_docs_project_contributor FAS/CLA sign-up.] | * You may use your [https://fedoraproject.org/wiki/EmailAliases fedoraproject.org email alias] which is granted to you upon successful [https://fedoraproject.org/wiki/Docs_Project_contributor_expectations#Become_a_docs_project_contributor FAS/CLA sign-up.] | ||
--> | |||
== Pointers for contributors looking for documents to write == | == Pointers for contributors looking for documents to write == | ||
Revision as of 21:30, 7 July 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). Once you have a FAS account, you will be granted a fedoraproject.org email alias.
On Licensing / Copyrights
This wiki is under Creative Commons Attribution-Share Alike 3.0 Unported License (see 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 new contributors task list.
- 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 on the Docs mailing list.
How it all gets done
- Check out the Docs Project workflow
- Works that are ready go into the next Fedora release.