From Fedora Project Wiki

m (internal link cleaning)
(Corrected link to Bugzilla)
Line 31: Line 31:
 
* Check out the [[Docs_Project_meetings#Guides| guides table]] and find a documentation buddy.  
 
* Check out the [[Docs_Project_meetings#Guides| guides table]] and find a documentation buddy.  
 
* The wiki itself needs to be gardened. Check out the [[:Category:Pages_that_need_love| pages that need love index.]]
 
* The wiki itself needs to be gardened. Check out the [[: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.]
+
* [https://bugzilla.redhat.com/buglist.cgi?query_format=advanced&order=Importance&bug_status=NEW&bug_status=ASSIGNED&classification=Fedora&product=Fedora%20Documentation Pojďme lovit chyby.]
 
* Have some other crazy idea? Great! Let's discuss it on the [https://admin.fedoraproject.org/mailman/listinfo/docs Docs mailing list].
 
* Have some other crazy idea? Great! Let's discuss it on the [https://admin.fedoraproject.org/mailman/listinfo/docs Docs mailing list].
  

Revision as of 19:57, 8 March 2018

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 command line tool for converting DocBook XML documents into other formats, such as HTML, PDF, and EPUB.
  • Works not directly saved into the wiki should be saved in git via Fedora Hosted.

Pointers for contributors looking for documents to write

How it all gets done