Help:Discussion

From Team Fortress Wiki
Revision as of 20:55, 13 September 2021 by GrampaSwood (talk | contribs) (This is the best way I could incorporate the outdent template, but I can't see it mentioned anywhere before. I've set the max at 7 or 8 for now, feel free to disagree.)
Jump to: navigation, search

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 and outdentation

Indentation

Please indent by using the colon ( : ) 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

Outdentation

Please outdent by using the {{Outdent}} template. A general guideline for when to use this template is to use it when you've hit over 7-8 or more indents. As a template parameter, use the amount of indents last used.

Incorrect:

:::::::I've hit 7 indents. -- Person A

::::::::I've hit 8 indents. -- Person B

Correct:

:::::::I've hit 7 indents. -- Person A

┌───────┘ 
I would have hit 8 indents, but have used the outdent template to make it look better. -- Person B

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.