Editing Chabadpedia:Manual of Style/Layout (section)

==Body sections==
{{Shortcut|MOS:BODY}}
{{further|Help:Section|Chabadpedia:Manual of Style#Article titles, headings, and sections}}
Articles longer than a [[CP:stub|stub]] are generally divided into sections, and sections over a certain length are generally divided into paragraphs: these divisions enhance the readability of the article. Recommended names and orders of section headings may [[#Specialized layout|vary by subject matter]], although articles should still follow good organizational and writing principles regarding sections and paragraphs.

===Headings and sections===
{{shortcut|MOS:OVERSECTION}}
{{further|Chabadpedia:Manual of Style#Section headings}}
[[File:Chabadpedia layout sample bodies.png|thumb|upright=0.8|alt=The same article, with the central left highlighted: it contains just text in sections.|Body sections appear after the lead and table of contents (click on image for larger view).]]

Headings introduce sections and subsections, clarify articles by breaking up text, organize content, and populate the [[Help:Section#Table of contents (TOC)|table of contents]]. Very short sections and subsections clutter an article with headings and inhibit the flow of the prose. Short paragraphs and single sentences generally do not warrant their own subheadings.

Headings follow a six-level hierarchy, starting at 1 and ending at 6. The level of the heading is defined by the number of equals signs on each side of the title. Heading 1 (<code>= Heading&nbsp;1 =</code>) is automatically generated as the title of the article, and is never appropriate within the body of an article. Sections start at the second level (<code>== Heading&nbsp;2 ==</code>), with subsections at the third level (<code>=== Heading&nbsp;3 ===</code>), and additional levels of subsections at the fourth level (<code>==== Heading&nbsp;4 ====</code>), fifth level, and sixth level. Sections should be consecutive, such that they do not skip levels from sections to sub-subsections; the exact methodology is part of the [[Chabadpedia:Manual of Style/Accessibility|Accessibility]] guideline.{{efn|1=For example, skipping heading levels, such as jumping from <code>== Heading&nbsp;2 ==</code> to <code>==== Heading&nbsp;4 ====</code> without <code>=== Heading&nbsp;3 ===</code> in the middle, violates [[Chabadpedia:Accessibility]] as it reduces usability for users of screen readers who use heading levels to navigate pages.}} Between sections, there should be a {{em|single}} blank line: multiple blank lines in the edit window create too much white space in the article. There is no need to include a blank line between a heading and sub-heading. When changing or removing a heading, consider adding an [[Template:Anchor|anchor template]] with the original heading name to provide for [[CP:incoming external links|incoming external links]] and [[CP:wikilink|wikilink]]s (preferably using <code><nowiki>{{subst:anchor}}</nowiki></code> rather than using <code><nowiki>{{anchor}}</nowiki></code> directly—see [[MOS:RENAMESECTION]]).

===Section order{{Anchor|Names and orders for section headings}}===
{{short|MOS:SNO}}
{{See also|Help:Section|CP:Manual of Style/Accessibility#Headings|CP:Manual of Style#Section headings|CP:Manual of Style/Capital letters#Section headings}}

Because of the diversity of subjects it covers, Chabadpedia has no general standard or guideline regarding the order of section headings within the body of an article. The usual practice is to order body sections based on the precedent of similar articles. For exceptions, see [[#Specialized layout|Specialized layout]] below.

===Section templates and summary style===
<!--Linked from [[Chabadpedia:How to copy-edit]]-->
{{further|CP:SUMMARYHATNOTE|Chabadpedia:Summary style#Templates}}

When a section is a [[Chabadpedia:Summary style|summary]] of another article that provides a full exposition of the section, a link to the other article should appear immediately under the section heading. You can use the {{tlx|Main}} template to generate a "Main article" link, in Chabadpedia's [[Chabadpedia:Hatnote|"hatnote"]] style.

If one or more articles provide further information or additional details (rather than a full exposition, see above), links to such articles may be placed immediately after the section heading for that section, provided this does not duplicate a wikilink in the text. These additional links should be grouped along with the {{tnull|Main}} template (if there is one), or at the foot of the section that introduces the material for which these templates provide additional information. You can use one of the following templates to generate these links:
* {{tlx|Further}}{{snd}} generates a "Further information" link
* {{tlx|See also}}{{snd}} generates a "See also" link

For example, to generate a "See also" link to the article on [[Chabadpedia:How to edit a page]], type {{tlx|See also|Chabadpedia:How to edit a page}}, which will generate:
{{xt|{{See also|Chabadpedia:How to edit a page}}}}

===Paragraphs===
{{shortcut|MOS:PARA|MOS:LINEBREAKS}}
{{redirect|MOS:LINEBREAKS|preventing line breaks|Chabadpedia:Manual of Style#Controlling line breaks}}
{{See also|CP:Writing better articles#Paragraphs|Help:Wikitext#Line breaks|CP:Manual of Style/Accessibility#Indentation}}

Sections usually consist of paragraphs of running prose, each dealing with a particular point or idea. Single-sentence paragraphs can inhibit the flow of the text; by the same token, long paragraphs become hard to read. Between paragraphs—as between sections—there should be only a {{em|single}} blank line. First lines are {{em|not}} indented. 

[[Bullet (typography)#Bullet points|Bullet points]] should not be used in the lead of an article.  They may be used in the body to break up a mass of text, particularly if the topic requires significant effort to comprehend. Sometimes, it may be preferable to use bullet points instead of having a series of very short paragraphs. However, bulleted lists are typical in the reference, further reading, and external links sections towards the end of the article. Bullet points are usually not separated by blank lines, as that causes an accessibility issue (''see'' [[MOS:LISTGAP]] for ways to create multiple paragraphs within list items that do not cause this issue).
Description	What you type	What you get
Italic	''Italic text''	Italic text
Bold	'''Bold text'''	Bold text
Bold & italic	'''''Bold & italic text'''''	*Bold & italic text*