Writing Documentation

Skip to end of metadata
Go to start of metadata

Question 1: In Confluence or in the source tree?

Well, it's sometimes hard. So here's the guideline:

  1. If the piece of documentation is useful to a non-developer who uses/administers an instance of SIO2, it should be in Confluence.
Hint
In Confluence we have some redirecting pages. To edit such a page, enter its URL with #noredirect appended. The redirect will be disabled.

Question 2: How to write documentation in the source tree?

This documentation resides in the code and in folders doc/rst and sioworkers/*/rst.

Follow reStructuredText Primer and be consistent.

This documentation goes through our standard creating a change workflow.

Question 3: How to write documentation in Confluence?

Well, use common sense and write short articles. Try to be as attractive, as possible.

Todo
At the moment there is no convenient way for external contributors to edit our documentation.
Please forgive us and leave propositions on what to change in the comments!

Some ideas:

  • Creating diagrams with Gliffy is übereasy (use the Insert/Edit Macro button in Wiki Markup Editor and look for Gliffy).
Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.