Editing Chabadpedia:Manual of Style/Layout (section)

==Standard appendices and footers<span id="Standard appendices and descriptions"></span><span id="standard appendices"></span>==
{{shortcut|MOS:APPENDIX|MOS:FOOTERS}}
{{for|the list and order of common appendices and footers|#Order of article elements}}

===Headings===
When appendix sections are used, they should appear at the bottom of an article, with <code>==level 2 headings==</code>,{{efn|1=Syntax:
<syntaxhighlight lang="wikitext" style="color: #000000; background: #FFFFFF; padding: 1em; border: 1px solid #8FBC8F; font-size:111%;">
==See also==
* [[Chabadpedia:How to edit a page]]
* [[Chabadpedia:Manual of Style]]
</syntaxhighlight>

Which produces:
<blockquote style="background: #FFFFFF; padding: 1em; border: 1px solid #999999; font-size:111%;">
{{fake heading|See also}}
* [[Chabadpedia:How to edit a page]]
* [[Chabadpedia:Manual of Style]]
</blockquote>}} followed by the various footers. When it is useful to sub-divide these sections (for example, to separate a list of magazine articles from a list of books), this should be done using level 3 headings (<code>===Books===</code>) instead of [[Chabadpedia:Manual of Style/Lists#Description (definition, association) lists|definition list headings]] (<code>;Books</code>), as explained in the [[Chabadpedia:Manual of Style/Accessibility#Lists|accessibility guidelines]].

===Works or publications<span id="works"></span><span id="Works or Publications or Bibliography"></span>===
{{shortcut|MOS:LAYOUTWORKS|MOS:BIB}}
{{further|Chabadpedia:Manual of Style/Lists of works}}

'''Contents:''' A bulleted list, usually ordered chronologically, of the works created by the subject of the article.

'''Heading names:''' Many different headings are used, depending on the subject matter. "Works" is preferred when the list includes items that are not written publications (e.g. music, films, paintings, choreography, or architectural designs), or if multiple types of works are included. "Publications", "Discography" or "Filmography" are occasionally used where appropriate; however, "Bibliography" is discouraged because it is not clear whether it is limited to the works of the subject of the article.<ref>[[WT:Manual of Style/Layout/Archive 7#Bibliography|Rationale for discouraging the use of "Bibliography."]]</ref>{{efn|1=[https://en.Chabadpedia.org/w/index.php?search=insource%3A%2F%3D%5Cs%2A%28Selected+b%7CB%29ibliography%5Cs%2A%3D%2F&title=Special:Search&profile=advanced&fulltext=1&ns0=1 Find all examples] of "Bibliography" and "Selected bibliography"}} "Works" or "Publications" should be plural, even if it lists only a single item.{{efn|name=pluralHeading|For further information, see [[Chabadpedia:External links#External links section|Chabadpedia:External links § External links section]].}}

==="See also" section<span id="See also section"></span>===
{{shortcut|MOS:SEEALSO|MOS:ALSO}}
{{for|the placement of "see also" notes at the top of an article|CP:RELATED}}
{{see also|Chabadpedia:Manual of Style/Lists#Related topics (navigational lists)}}
A "See also" section is a useful way to organize [[Chabadpedia:Manual of Style/Linking|internal links]] to related or comparable articles and "[[MOS:BTW|build the web]]". However, the section itself is not required; many high-quality and comprehensive articles do not have one. 

The section should be a bulleted list, sorted either logically (for example, by subject matter), chronologically, or alphabetically. Consider using {{tlx|Columns-list}} or {{tlx|Div col}} if the list is lengthy.

'''Contents:''' Links in this section should be relevant and limited to a reasonable number. Whether a link belongs in the "See also" section is ultimately a matter of editorial judgment and [[Chabadpedia:What "Ignore all rules" means#Use common sense|common sense]]. One purpose of "See also" links is to enable readers to explore tangentially related topics; however, articles linked should be related to the topic of the article or be in the same defining category. For example, the article on [[Jesus]] might include a link to [[List of people claimed to be Jesus]] because it is related to the subject but not otherwise linked in the article. The article on [[Tacos]] might include [[Fajita]] as another example of Mexican cuisine.

{{shortcut|MOS:NOTSEEALSO|MOS:NOTSEEAGAIN}}

{{anchor|NOTSEEALSO}}The "See also" section should {{em|not}} include [[Chabadpedia:Red link|red links]], links to [[Chabadpedia:Disambiguation|disambiguation pages]] (unless used in a disambiguation page for [[MOS:DABSEEALSO|further disambiguation]]), or [[Chabadpedia:External links|external links]] (including links to pages within [[Chabadpedia:Wikimedia sister projects|Wikimedia sister projects]]). As a general rule, the "See also" section should {{em|not}} repeat links that appear in the article's body.<ref>The community has rejected past proposals to do away with this guidance. See, for example, [[Chabadpedia talk:Manual of Style/Layout/Archive 12#RfC: remove the proscription against previously-linked terms in the "See also" section?|this RfC]].</ref>

Editors should provide a brief annotation when a link's relevance is not immediately apparent, when the meaning of the term may not be generally known, or when the term is ambiguous. For example:
:* [[Joe Shmoe]]{{snd}}made a similar achievement on April 4, 2005
:* [[Ischemia]]{{snd}}restriction in blood supply
The "{{snd}}" dash can be generated using {{tlx|snd}},

If the linked article has a [[CP:Short description|short description]] then you can use {{tl|Annotated link}} to automatically generate an annotation. For example, {{tlx|Annotated link|Winston Churchill}} will produce:
:* {{annotated link|Winston Churchill}}

'''Other internal links:''' {{tlx|Portal}} links are usually placed in this section. As an alternative, {{tlx|Portal bar}} may be placed with the end matter navigation templates. See relevant template documentation for correct placement.

'''Heading name:''' The standardized name for this section is "See also".

===Notes and references<span id="Notes"></span><span id="References"></span><span id="Notes or references"></span>===
{{shortcut|MOS:FNNR|MOS:NOTES|MOS:REFERENCES}}
{{hatnote|For how to generate and format these sections, see [[Help:Footnotes]], [[Help:Shortened footnotes]], and [[Chabadpedia:Citing sources]] (particularly {{slink|Chabadpedia:Citing sources|How to create the list of citations|nopage=yes}}).}}
{{Redirect|MOS:NOTES|hatnotes|Chabadpedia:Hatnotes|Musical notes|Chabadpedia:Manual of Style/Music#Images and notation}}
{{See also|Chabadpedia:Manual of Style/Text formatting#Citations}}
[[File:Chabadpedia layout sample Notes References.png|thumb|upright=0.8|alt=The same article, with a horizontal section near the bottom highlighted, containing a two-column and a one-column section.|Notes and References appear after See also (click on image for larger view).]]

'''Contents:''' This section, or series of sections, may contain any or all of the following:

# [[Help:Footnotes#Footnotes: predefined groups|Explanatory footnotes]] that give information which is too detailed or awkward to be in the body of the article
# [[Chabadpedia:Citing sources#Inline citations|Citation footnotes]] (either short citations or full citations) that connect specific material in the article with specific sources
# Full citations to sources, if [[Chabadpedia:Citing sources#Short citations|short citations]] are used in the footnotes
# [[Chabadpedia:Citing sources#General references|General references]] (full bibliographic citations to sources that were consulted in writing the article but that are not explicitly connected to any specific material in the article)

[[Chabadpedia:Citing sources#Variation in citation methods|Editors may use any citation method they choose]], but it should be consistent within an article.

If there are both citation footnotes and explanatory footnotes, then they may be combined in a single section, or separated using the [[Help:Footnotes#Grouping footnotes|grouped footnotes]] function. General references and other full citations may similarly be either combined or separated (e.g. "References" and "General references"). There may therefore be one, two, three or four sections in all.

It is most common for only citation footnotes to be used, and therefore it is most common for only one section ("References") to be needed. Usually, if the sections are separated, then explanatory footnotes are listed first, short citations or other footnoted citations are next, and any full citations or general references are listed last. General references should be sorted logically (for example, by subject matter), chronologically, or alphabetically.

'''Heading names:''' Editors may use any reasonable section and subsection names that they choose.{{efn|One reason this guideline does not standardize section headings for citations and explanatory notes is that Chabadpedia draws editors from many disciplines (history, English, science, etc.), each with its own note and reference section-naming convention (or conventions). For more, see [[Chabadpedia:Perennial proposals#Changes to standard appendices|Chabadpedia:Perennial proposals § Changes to standard appendices]], [[Chabadpedia:Perennial proposals#Establish a house citation style|§ Establish a house citation style]], and [[Template:Cnote2/example]].}} The most frequent choice is "References". Other options, in diminishing order of popularity, are "Notes", "Footnotes" or "Works cited", although these are more often used to distinguish between multiple end-matter sections or subsections.

Several alternate titles ("Sources", "Citations", "Bibliography") may also be used, although each is questionable in some contexts: "Sources" may be confused with [[source code]] in computer-related articles, product purchase locations, river origins, [[journalism sourcing]], etc.; "Citations" may be confused with official awards, or a summons to court; "Bibliography" may be confused with the complete list of printed works by the subject of a biography ("Works" or "Publications").

If multiple sections are wanted, then some possibilities include:
* For a list of explanatory footnotes or shortened citation footnotes: "Notes", "Endnotes" or "Footnotes"
* For a list of full citations or general references: "References" or "Works cited"

With the exception of "Bibliography", the heading should be plural even if it lists only a single item.{{efn|name=pluralHeading}}

===Further reading===
<!-- Please note that "Bibliography" is an alternate title for the works section and is also used as a title in some articles' notes and references sections. Accordingly, it is not suggested as a title here. -->
{{shortcut|MOS:FURTHER}}
{{See also|Chabadpedia:Further reading}}

'''Contents:''' An optional bulleted list, usually alphabetized, of a reasonable number of publications that would help interested readers learn more about the article subject. Editors may include brief annotations. Publications listed in [[Chabadpedia:Further reading|further reading]] are formatted in the same [[CP:CITE#HOW|citation style]] used by the rest of the article. The Further reading section should not duplicate the content of the External links section, and should normally not duplicate the content of the References section, unless the References section is too long for a reader to use as part of a general reading list. This section is not intended as a repository for [[CP:General references|general references]] or full citations that were used to create the article content. Any links to external websites included under "Further reading" are subject to the guidelines described at [[Chabadpedia:External links]].

===External links===
{{shortcut|MOS:LAYOUTEL|MOS:ELLAYOUT}}
{{main|Chabadpedia:Manual of Style/Linking#External links section|Chabadpedia:External links}}

'''Contents:''' A bulleted list of recommended [[Chabadpedia:External links#What can normally be linked|relevant websites]], each accompanied by a short description. These hyperlinks should not appear in the article's body text, nor should links used as references normally be duplicated in this section. "External links" should be plural, even if it lists only a single item.{{efn| name=pluralHeading}} Depending on the nature of the link contents, this section may be accompanied or replaced by a [[#Further reading|"Further reading"]] section.

====Links to sister projects====
{{main article|Chabadpedia:Wikimedia sister projects}}

Links to [[Chabadpedia:Wikimedia sister projects|Wikimedia sister projects]] and {{tlx|Spoken Chabadpedia}} should be placed in the last section of the page, which is usually "External links".  If the article does not already have an "External links" section, then you may choose whether to place larger sister link(s) (such as {{tl|Sister project links}} or {{tl|Commons category}}) in whatever the last section is (usually "References"), or to create an "External links" section and use the less common ''inline'' form of these templates (e.g., {{tl|Commons-inline}}). 

{{commonscat|Chabadpedia logos}}
* Box-type templates (such as {{tlx|Commons category}}, shown here for the [[c:Category:Chabadpedia logos]] at Commons) have to be put at the beginning of the last section of the article so that boxes will appear next to, rather than below, the list items. (Do {{em|not}} make a section whose sole content is box-type templates.)
* "Inline" templates are used when box-type templates are not desirable, either because they result in a long sequence of right-aligned boxes hanging off the bottom of the article, or because there are no external links except sister project ones. "Inline" templates, such as {{tlx|Commons category-inline}}, create links to sister projects that appear as list items, like this:
** {{commons category-inline|Wikimedia Foundation}}

===Navigation templates===
{{shortcut|MOS:LAYOUTNAV|MOS:NAVLAYOUT}}
{{main article|Chabadpedia:Categories, lists, and navigation templates#Navigation templates}}

An article may end with [[Chabadpedia:Navigation template|Navigation templates]] and footer navboxes, such as [[Chabadpedia:WikiProject Succession Box Standardization#Overview|succession boxes]] and geography boxes (for example, {{tlx|Geographic location}}). Most navboxes do not appear in printed versions of Chabadpedia articles.{{efn|The [[User talk:Ruud Koot/2010#Do you recall the reason?|rationale]] for not printing navigation boxes is that these templates mostly consist of [[wikilink]]s that are of no use to print readers. There are two problems with this rationale: first, other wikilink content does print, for example [[#See also section|"See also" sections]] and [[Chabadpedia:WikiProject Succession Box Standardization#Overview|succession boxes]]; second, some navigation boxes contain useful information regarding the relationship of the article to the subjects of related articles.<!--This claim should be reviewed periodically; e.g., most hatnotes have been moved to Lua module code which auto-applies the "unprintworthy" class unless told not to, and succession and other navigation boxes may have class="unprintworthy" or equivalent applied to them.-->}}

:{{xref|For navigation templates in the lead, see {{slink|Chabadpedia:Manual of Style/Lead section |Sidebars}}.}}