-
Notifications
You must be signed in to change notification settings - Fork 74
Documentation Style
rzanoli edited this page Jan 18, 2014
·
19 revisions
EOP documentation is written as wiki pages by using the GitHub wiki editor. These are the adopted conventions to follow to create new wiki pages or edit existing ones:
- Using English for the documentation.
- Using proper page titles and avoid creating duplicate pages.
- Annotate those parts which still need future work, clarification and/or explanation and/or verification with @TODO annotation marks.
- Markdown plain text formatting syntax should be used (http://en.wikipedia.org/wiki/Markdown).
- Quite long pages should have an Abstract to introduce its content and an Index reporting links to the page's Sections.
An abstract is a brief summary of the page's content, and is used to help the reader quickly ascertain the page's purpose.
Here is the content of the Section 1 that can contain subsections too, e.g.
Here is the content of the Section 2