UniWiki:Manual of Style: Difference between revisions

Line 24:

== Article titles ==

~~{{main|UniWiki:Article titles}}~~

When choosing an article's title, refer to the [~~[UniWiki~~:~~Article titles|~~article titles]] policy. A title should be a recognizable name or description of the topic that is natural, sufficiently precise, concise, and consistent with the titles of related articles. If these criteria are in conflict, they should be balanced against one another.

When choosing an article's title, refer to the [https://en.wikipedia.org/wiki/Wikipedia:Article_titles article titles] policy. A title should be a recognizable name or description of the topic that is natural, sufficiently precise, concise, and consistent with the titles of related articles. If these criteria are in conflict, they should be balanced against one another.

For guidance on formatting titles, see ~~{{section link|UniWiki~~:~~Article titles|~~Article title format}} section of the policy. Note the following:

For guidance on formatting titles, see the [https://en.wikipedia.org/wiki/Wikipedia:Article_titles#Article_title_format Article title format] section of the policy. Note the following:

* Capitalize the title's initial letter (except in rare cases where the first letter is purposely lowercase), but otherwise follow [https://en.wikipedia.org/wiki/Letter_case#Sentence_case sentence case], not title case; e.g., Funding of EVE University projects, not Funding of EVE University Projects. This does not apply where title case would be expected were the title to occur in ordinary prose. See [~~[UniWiki~~:Naming conventions (capitalization)]] for more details.

* Capitalize the title's initial letter (except in rare cases where the first letter is purposely lowercase), but otherwise follow [https://en.wikipedia.org/wiki/Letter_case#Sentence_case sentence case], not title case; e.g., Funding of EVE University projects, not Funding of EVE University Projects. This does not apply where title case would be expected were the title to occur in ordinary prose. See [https://en.wikipedia.org/wiki/Wikipedia:Naming_conventions_(capitalization) Naming conventions (capitalization)] for more details.

* Do not use {{notthis|A}}, {{notthis|An}}, or {{notthis|The}} as the first word ({{dothis|Economy of the Caldari State}}, not {{notthis|The economy of the Caldari State}}), unless it is an inseparable part of a name ({{dothis|The Broker}}) or it is part of the title of a work (''{{dothis|The Seven Events of the Apocalypse}}'', ''{{dothis|The Scope}}'').

* Titles should normally be [https://en.wikipedia.org/wiki/Noun nouns] or [https://en.wikipedia.org/wiki/Noun_phrase noun phrases]: {{dothis|Early life}}, not {{notthis|In early life}}.<ref>Using phrases like {{dothis|In early life}} is acceptable for section headings.</ref>

Line 58:

Line 57:

Other article elements include [https://en.wikipedia.org/wiki/Wikipedia:Hatnote disambiguation hatnotes] (normally placed at the very top of the article) and [[UniWiki:Manual of Style/Infobox|infoboxes]] (usually placed before the lead section).

== Section headings ==

{{see also|UniWiki:Manual of Style/Accessibility#Headings|UniWiki:Manual of Style/Layout#Order of article elements}}

Use equal signs to mark the enclosed text as a section heading: <code><nowiki>=Title=</nowiki></code> for a primary section; <code><nowiki>==Title==</nowiki></code> for the next level (a subsection); and so on to the lowest-level subsection, with <code><nowiki>=====Title=====</nowiki></code>. Spaces between the equal signs and the heading text are optional, and will not affect the way the heading is displayed. The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit window (but not two or more consecutive blank lines, which will add unnecessary visible space in the rendered page). There is no need to include a blank line between a heading and sub-heading.

The provisions in {{section link||Article titles}} generally apply to section headings as well (for example, headings are in sentence case, not title case). The following points apply specifically to section headings:

* Headings should not refer redundantly to the subject of the article, or to higher-level headings, unless doing so is shorter or clearer. ({{dothis|Early life}} is preferable to {{notthis|His early life}} when ''his'' refers to the subject of the article; headings can be assumed to be about the subject unless otherwise indicated.)

* Section and subsection headings should preferably be unique within a page; otherwise section links may lead to the wrong place, and automatic edit summaries can be ambiguous.

* Citations should not be placed within or on the same line as section and subsection headings.

* Avoid starting headings with numbers (other than years), because this can be confusing for readers with the "Auto-number headings" preference selected.

Before changing a section heading, consider whether you might be breaking existing links to that section.

When placing an invisible comment on the same line as the heading, do not do this ''outside'' the <code><nowiki>== ==</nowiki></code> markup:<ref>Placing comments in this way disrupts the software's handling of section edits and their edit summaries, and even heading display. For example, if one clicks the edit section button, the section heading is not automatically added to the edit summary; or in some cases, the edit section button fails to appear at all.</ref>

{{code|<nowiki>==Evolutionary implications== </nowiki>}}

{{code|<nowiki>==Evolutionary implications== </nowiki>}}

Several of the above provisions are also applicable to table headers, including sentence case and redundancy. Table headers are often useful places for citations (e.g., the source of all the data in a column), and many do begin with or are numbers. Table headers do not automatically generate link anchors. ''(For more information see {{Section link|UniWiki:Manual of Style/Tables|Captions and headers}}.)''

=Notes=

@@ Line 24: / Line 24: @@
 == Article titles ==
-{{main|UniWiki:Article titles}}
-When choosing an article's title, refer to the [[UniWiki:Article titles|article titles]] policy. A title should be a recognizable name or description of the topic that is natural, sufficiently precise, concise, and consistent with the titles of related articles. If these criteria are in conflict, they should be balanced against one another.
+When choosing an article's title, refer to the [https://en.wikipedia.org/wiki/Wikipedia:Article_titles article titles] policy. A title should be a recognizable name or description of the topic that is natural, sufficiently precise, concise, and consistent with the titles of related articles. If these criteria are in conflict, they should be balanced against one another.
-For guidance on formatting titles, see {{section link|UniWiki:Article titles|Article title format}} section of the policy. Note the following:
+For guidance on formatting titles, see the [https://en.wikipedia.org/wiki/Wikipedia:Article_titles#Article_title_format Article title format] section of the policy. Note the following:
-* Capitalize the title's initial letter (except in rare cases where the first letter is purposely lowercase), but otherwise follow [https://en.wikipedia.org/wiki/Letter_case#Sentence_case sentence case], not title case; e.g., <span style="color:green">Funding of EVE University projects</span>, not <span style="color:red">Funding of EVE University Projects</span>. This does not apply where title case would be expected were the title to occur in ordinary prose. See [[UniWiki:Naming conventions (capitalization)]] for more details.
+* Capitalize the title's initial letter (except in rare cases where the first letter is purposely lowercase), but otherwise follow [https://en.wikipedia.org/wiki/Letter_case#Sentence_case sentence case], not title case; e.g., <span style="color:green">Funding of EVE University projects</span>, not <span style="color:red">Funding of EVE University Projects</span>. This does not apply where title case would be expected were the title to occur in ordinary prose. See [https://en.wikipedia.org/wiki/Wikipedia:Naming_conventions_(capitalization) Naming conventions (capitalization)] for more details.
 * Do not use {{notthis|A}}, {{notthis|An}}, or {{notthis|The}} as the first word ({{dothis|Economy of the Caldari State}}, not {{notthis|The economy of the Caldari State}}), unless it is an inseparable part of a name ({{dothis|The Broker}}) or it is part of the title of a work (''{{dothis|The Seven Events of the Apocalypse}}'', ''{{dothis|The Scope}}'').
 * Titles should normally be [https://en.wikipedia.org/wiki/Noun nouns] or [https://en.wikipedia.org/wiki/Noun_phrase noun phrases]: {{dothis|Early life}}, not {{notthis|In early life}}.<ref>Using phrases like {{dothis|In early life}} is acceptable for section headings.</ref>
@@ Line 58: / Line 57: @@
 Other article elements include [https://en.wikipedia.org/wiki/Wikipedia:Hatnote disambiguation hatnotes] (normally placed at the very top of the article) and [[UniWiki:Manual of Style/Infobox|infoboxes]] (usually placed before the lead section).
+== Section headings ==
+{{see also|UniWiki:Manual of Style/Accessibility#Headings|UniWiki:Manual of Style/Layout#Order of article elements}}
+Use equal signs to mark the enclosed text as a section heading: <code><nowiki>=Title=</nowiki></code> for a primary section; <code><nowiki>==Title==</nowiki></code> for the next level (a subsection); and so on to the lowest-level subsection, with <code><nowiki>=====Title=====</nowiki></code>. Spaces between the equal signs and the heading text are optional, and will not affect the way the heading is displayed. The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit window (but not two or more consecutive blank lines, which will add unnecessary visible space in the rendered page). There is no need to include a blank line between a heading and sub-heading.
+The provisions in {{section link||Article titles}} generally apply to section headings as well (for example, headings are in sentence case, not title case). The following points apply specifically to section headings:
+* Headings should not refer redundantly to the subject of the article, or to higher-level headings, unless doing so is shorter or clearer. ({{dothis|Early life}} is preferable to {{notthis|His early life}} when ''his'' refers to the subject of the article; headings can be assumed to be about the subject unless otherwise indicated.)
+* Section and subsection headings should preferably be unique within a page; otherwise section links may lead to the wrong place, and automatic edit summaries can be ambiguous.
+* Citations should not be placed within or on the same line as section and subsection headings.
+* Avoid starting headings with numbers (other than years), because this can be confusing for readers with the "Auto-number headings" preference selected.
+Before changing a section heading, consider whether you might be breaking existing links to that section.
+When placing an invisible comment on the same line as the heading, do not do this ''outside'' the <code><nowiki>==&nbsp;==</nowiki></code> markup:<ref>Placing comments in this way disrupts the software's handling of section edits and their edit summaries, and even heading display. For example, if one clicks the edit section button, the section heading is not automatically added to the edit summary; or in some cases, the edit section button fails to appear at all.</ref><br><br>
+{{code|<nowiki>==Evolutionary implications==<!--This comment disrupts editing--> </nowiki>}}<br>
+{{code|<nowiki><!--This comment disrupts display as well as editing-->==Evolutionary implications== </nowiki>}}<br>
+Several of the above provisions are also applicable to table headers, including sentence case and redundancy. Table headers are often useful places for citations (e.g., the source of all the data in a column), and many do begin with or are numbers. Table headers do not automatically generate link anchors. ''(For more information see {{Section link|UniWiki:Manual of Style/Tables|Captions and headers}}.)''
 =Notes=
 {{Reflist}}