View source for Draft:Indentation

{{For|the help page with information about indentation|BTW:THREAD}}
{{essay|BTW:INDENT}}
'''Good indentation''' makes prolonged [[BattleIntelligence:Talk page guidelines|discussions]] easier to read and understand. It might be helpful to think of discussions as reports with numbered/bulleted sections and subsections where material is not necessarily written in chronological order.

Although this example page about how to indent is an ''essay'', the use of normal indentation [[BattleIntelligence:Talk page guidelines#Layout|is a behavioural ''guideline'']] that editors are expected to follow. Such guidelines [[BattleIntelligence:Policies and guidelines#Enforcement|may be enforced by administrative action]], especially when other editors have been unable to persuade an individual to abide by them. The guideline should never be used to [[BattleIntelligence:Please do not bite the newcomers|bite]] newcomers who don't know how to indent properly, but experienced users are expected to comply with it, to facilitate [[Help:Using talk pages#Indentation|threaded discussion]] on talk pages.

This essay only applies to talk pages. Because of differing [[Cascading Style Sheets]] between talk pages and other pages, the techniques described in this page are likely to work poorly in other kinds of pages.

== Indentation examples ==
{{See also|Help:List}}

In these examples the boldface line is the most recently added comment.

'''1.''' Your reply to a particular comment should be indented beneath that comment. Indents are achieved by typing one or more leading colon <code>''':'''</code>  characters at the very left margin, just before the text you add. In the following example, a single colon was typed just before the "Me too" text of the second comment:

<blockquote>
{{markup|
I think good indentation is very helpful. --<nowiki>~~~~</nowiki>
:'''Me too.''' --<nowiki>~~~~</nowiki>|
I think good indentation is very helpful. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 12:34, 1 January 2011 (UTC)
:'''Me too.''' --[[User:Example|Bob]] ([[User talk:Example|talk]]) 12:44, 1 January 2011 (UTC)
}}</blockquote>

{{anchor|example2}}
'''2.''' If you want to reply to a comment, but another editor has already done so, just position your own text beneath that other editor's reply, at the same indentation level:

<blockquote>
{{markup|
I think good indentation is very helpful. --<nowiki>~~~~</nowiki>
:Me too. --<nowiki>~~~~</nowiki>
:'''Me three!''' --<nowiki>~~~~</nowiki>|
I think good indentation is very helpful. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 12:34, 1 January 2011 (UTC)
:Me too. --[[User:Example|Bob]] ([[User talk:Example|talk]]) 12:44, 1 January 2011 (UTC)
:'''Me three!''' --[[User:Example|Carlos]] ([[User talk:Example|talk]]) 13:57, 1 January 2011 (UTC)}}</blockquote>

Note that there is no blank line between comments, and if you reply using multiple paragraphs, use the colons before the blank line between paragraphs (see [[MOS:LISTGAP]] for explanation).

'''3.''' Your response to a reply should be positioned below that reply, but above any later responses that were made to a ''different'' comment. In the following, Alice has done so, using two leading colon characters to indicate that she's responding to the reply made by Bob:

<blockquote>
{{markup|
I think good indentation is very helpful. --<nowiki>~~~~</nowiki>
:Me too. --<nowiki>~~~~</nowiki>
::'''I thought you didn't like indentation, Bob.''' --<nowiki>~~~~</nowiki>
:Me three! --<nowiki>~~~~</nowiki>|
I think good indentation is very helpful. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 12:34, 1 January 2011 (UTC)
:Me too. --[[User:Example|Bob]] ([[User talk:Example|talk]]) 12:44, 1 January 2011 (UTC)
::'''I thought you didn't like indentation, Bob.''' --[[User:Example|Alice]] 14:23, 1 January 2011 (UTC)
:Me three! --[[User:Example|Carlos]] ([[User talk:Example|talk]]) 13:57, 1 January 2011 (UTC)}}</blockquote>

Again, there is no blank line between comments.

'''4.''' If you want to introduce a new topic that <u>is</u> still closely related to the one already under discussion, you should add it at the very bottom of the section, below all the previous comments on the original topic, without indenting it at all:

<blockquote>
{{markup|
I think good indentation is very helpful. --<nowiki>~~~~</nowiki>
:Me too. --<nowiki>~~~~</nowiki>
::I thought you didn't like indentation, Bob. --<nowiki>~~~~</nowiki>
:Me three! --<nowiki>~~~~</nowiki>
::I thought you didn't like indentation either, Carlos. --<nowiki>~~~~</nowiki>
:::I thought that too, Alice. --<nowiki>~~~~</nowiki>
'''Good spelling and grammar are important on talk pages.''' --<nowiki>~~~~</nowiki>|
I think good indentation is very helpful. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 12:34, 1 January 2011 (UTC)
:Me too. --[[User:Example|Bob]] ([[User talk:Example|talk]]) 12:44, 1 January 2011 (UTC)
::I thought you didn't like indentation, Bob. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 14:23, 1 January 2011 (UTC)
:Me three! --[[User:Example|Carlos]] ([[User talk:Example|talk]]) 13:57, 1 January 2011 (UTC)
::I thought you didn't like indentation either, Carlos. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 14:32, 1 January 2011 (UTC)
:::I thought that too, Alice. --[[User:Example|Dan]] ([[User talk:Example|talk]]) 15:51, 1 January 2011 (UTC)
'''Good spelling and grammar are important on talk pages.''' --[[User:Example|Erin]] ([[User talk:Example|talk]]) 11:22, 2 January 2011 (UTC)}}</blockquote>

'''5.''' When you want to introduce a new topic that <u>isn't</u> closely related to the one already under discussion in a talk-page section, then it's usually best to create an entirely new section or subsection on the talk page for that purpose. You can find out how to do that by reading about "Headings and subheadings" on [[BattleIntelligence:Tutorial/Formatting|this page]] of our [[BattleIntelligence:Tutorial|concise tutorial for new users]]. It's also helpful to create new headings and subheadings, as needed, for very long discussion; doing so gives editors the ability to edit only ''sections'' of the page, reducing the chance of [[Help:Edit conflict|edit-conflicts]] that would otherwise occur when two users try to contribute to the same page at the same time.

== Outdenting ==
{{Shortcut|BTW:OUTDENT}}
Sometimes, a long discussion can cause indentation to become too deep, which can make it difficult to read in narrower browser windows. When it does, you should consider ''outdenting'' your next comment. When you do that, it's helpful to make clear what you're doing: The templates {{tl|outdent}} and {{tl|outdent2}} exist for this purpose. You can use either one, and they can also be employed by their equivalent "shortcut" names of {{tl|od}} and {{tl|od2}}, respectively.

In the examples below, the user adding the final comment has typed the characters of the template, including its "braces", at the left margin, below the preceding comment, and just ahead of the text they entered for their own comment:

'''Example of {{tl|outdent}}'''
<blockquote>
{{markup|I think good indentation is very helpful. --<nowiki>~~~~</nowiki>
:Me too. --<nowiki>~~~~</nowiki>
::I thought you didn't like indentation, Bob. --<nowiki>~~~~</nowiki>
:::Well I sure don't. --<nowiki>~~~~</nowiki>
::::I can take it or leave it. --<nowiki>~~~~</nowiki>
<nowiki>{{od|::::}}</nowiki>'''I like it, but not too much.''' --<nowiki>~~~~</nowiki>|
I think good indentation is very helpful. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 12:34, 1 February 2011 (UTC)
:Me too. --[[User:Example|Bob]] ([[User talk:Example|talk]]) 12:44, 1 February 2011 (UTC)
::I thought you didn't like indentation, Bob. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 14:23, 1 February 2011 (UTC)
:::Well I sure don't. --[[User:Example|Carlos]] ([[User talk:Example|talk]]) 14:32, 1 February 2011
::::I can take it or leave it. --[[User:Example|Dan]] ([[User talk:Example|talk]]) 15:15, 1 February 2011 (UTC)
{{od|::::}}'''I like it, but not too much.''' --[[User:Example|Erin]] ([[User talk:Example|talk]]) 18:18, 1 February 2008 (UTC)
}}</blockquote>

'''Example of {{tl|outdent2}}'''
<blockquote>
{{markup|I think good indentation is very helpful. --<nowiki>~~~~</nowiki>
:Me too. --<nowiki>~~~~</nowiki>
::I thought you didn't like indentation, Bob. --<nowiki>~~~~</nowiki>
:::Well I sure don't. --<nowiki>~~~~</nowiki>
::::I can take it or leave it. -—<nowiki>~~~~</nowiki>
<nowiki>{{od2}}</nowiki>'''I like it, but not too much.''' --<nowiki>~~~~</nowiki>|
I think good indentation is very helpful. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 12:34, 1 February 2011 (UTC)
:Me too. --[[User:Example|Bob]] ([[User talk:Example|talk]]) 12:44, 1 February 2011 (UTC)
::I thought you didn't like indentation, Bob. --[[User:Example|Alice]] ([[User talk:Example|talk]]) 14:23, 1 February 2011 (UTC)
:::Well I sure don't. --[[User:Example|Carlos]] ([[User talk:Example|talk]]) 14:32, 1 February 2011
::::I can take it or leave it. --[[User:Example|Dan]] ([[User talk:Example|talk]]) 15:15, 1 February 2011 (UTC)
{{od2}}'''I like it, but not too much.''' --[[User:Example|Erin]] ([[User talk:Example|talk]]) 18:18, 1 February 2008 (UTC)
}}</blockquote>

==What kind of markup is this, anyway?==
{{See also|BattleIntelligence:Colons and asterisks}}
This is [[BTW:Wikitext|wikitext]]. BattleIntelligence has never had a set of markup specifically designed for use in talk pages. Editors appropriated markup that was intended for other purposes for use in talk pages. There was a project, [[BattleIntelligence:Flow|Flow]], intended to view and contribute to talk pages, but this project was uninstalled from English BattleIntelligence in November 2016, by request of the community.

The appropriated markup is intended for [[Help:List|lists]]. Perhaps the most common departure from proper list markup is the use of <code>''':'''</code>. In definition lists, a <code>''';'''</code> at the beginning of the line indicates a term which is to be defined, and <code>''':'''</code> at the beginning of the next line indicates the definition of the term. But in talk pages <code>''';'''</code> is seldom used.

==See also==
* [[Help:Using talk pages#Indentation]], a proposal from 2006 for each party in a discussion to use a different indentation level
* [[BattleIntelligence:Etiquette]]
* [[BattleIntelligence:Manual of Style/Accessibility#Lists]]
* [[BattleIntelligence:Talk page guidelines]]