When editing discussion pages (especially open review sections), specific formatting and standards should be used.
Signing
Please sign your posts by adding "~~~~" to the end of your messages, or by clicking the signature button above the edit text box (second from the right).
Incorrect:
This is some discussion text.
Correct:
This is some discussion text. -- ~~~~
Indentation
Please indent by using the ( : ) character before your comments. Do not use bulleted lists ( * ), as you may disrupt another users comments.
Incorrect:
This is some discussion text. -- Person A *I'm responding to Person A. -- Person B **I'm responding to Person B. -- Person C
Correct:
This is some discussion text. -- Person A :I'm responding to Person A. -- Person B ::I'm responding to Person B. -- Person C
Spacing
Always add a blank line between your comment, and that of the person above you.
Incorrect:
This is some discussion text. -- Person A :I'm responding to Person A. -- Person B ::I'm responding to Person B. -- Person C
Correct:
This is some discussion text. -- Person A :I'm responding to Person A. -- Person B ::I'm responding to Person B. -- Person C
Flow
Place your comment below the person you're responding to.
Incorrect:
This is some discussion text. -- Person A This is some more discussion text. -- Person B This is also discussion text. -- Person C :I'm responding to Person A -- Person D
Correct:
This is some discussion text. -- Person A :I'm responding to Person A -- Person D This is some more discussion text. -- Person B This is also discussion text. -- Person C
Section headers
For clarity a section heading should be used when starting a new discussion topic.
Incorrect:
==Topic 1== This is some discussion text. -- Person A :I'm responding to Person A -- Person B I'm talking about something completely different. -- Person C
Correct:
==Topic 1== This is some discussion text. -- Person A :I'm responding to Person A -- Person B ==Topic 2== I'm talking about something completely different. -- Person C
By following these simple conventions, you drastically increase the readability of the discussion.
|