Include following information in your piece of work.
Be simple.
Be consistent.
Be detailed.
Proof read your documentation and use 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.
|
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 shot is a very powerful way to explain your idea. If you screen shot matches following criteria, then you are good to go!
Example: