Table of Contents

Formatting guidelines

General documentation structure.

Include following information in your piece of work.

  1. Title.
  2. Overview.
  3. Requirements.
  4. Version.
  5. Actions.
  6. Results.

General writing style tips.

Be simple.

Be consistent.

Be detailed.

Proof read your documentation and use standard formatting.

Standard formatting.

Formatting

Use formatting for:

Example:

''path/folder_name/filename'' File, folder and path names Input:
To edit amount of allowed attached files when sending private message go to ''ow_plugins/mailbox/classes/add_message_form.php''.

Result:
To edit amount of allowed attached files when sending private message go to ow_plugins/mailbox/classes/add_message_form.php.
**Button** Buttons, pages sections and feature names Input:
click **Save** and check your homepage once more.

Result:
click Save and check your homepage once more
Page 1 > Page Navigation between pages Go to Admin Panel > Settings > Languages
|**Note**: text | Notes to the text above the note. Input:
Hover the mouse over questions' name to see actions menu: delete and edit.
|**Note**: Username, password, email, real name, gender and birthday are system fields and can not be deleted.|

Result:
* log in to your control panel1* insert the code2 * refresh the page3 Bulleted list defining or describing available choices, options/actions Input:
*Delete-deletes user (profile and all of his files) from your site.
*Suspend-deactivates user.
*Re-activate-activates suspended users.

Result:
- item1 - item2 - item3 Numbered list defining or describing sequence of actions Input:
- log in to your control panel
- insert the code
- refresh the page

Result:
1.log in to your control panel
2.insert the code
3.refresh the page
<code> html/php/sql/css> a piece of </code > Highlight any piece of code. For example use <code php>Code here<</code> to highlight php code Input:
insert <code php> $multiUpload = new MultiFileField('attachments', 5);</code> and save changes.

Result:
insert $multiUpload = new MultiFileField('attachments', 5) and save changes.
http://[your_site_URL] Site links Input:
Documentation can be found at http://[http://docs.oxwall.org/]

Result:
Action 1 -> Action 2 Consistency between certain actions. Input:
Clear cache->Refresh page->Upload photo

Result:
Clear cache → Refresh page → Upload photo

Screen shots.

Screen shot is a very powerful way to explain your idea. If you screen shot matches following criteria, then you are good to go!

  1. Captures only related to your topic area.
  2. Is consistent to the text it is connected with.
  3. Is 400px (correlation 4:3) size.
  4. Is placed AFTER the text it belongs to.
  5. Selections and arrows within the screen shot are:
    • color: red (#ff0000)
    • scale: 0.5px.

Example: