TenthFleet:Manual of Style: Difference between revisions

(3 intermediate revisions by 2 users not shown)

Line 1:

::''The following Manual of Style is adapted from the document written and executed by [[memoryalpha:Memory_Alpha:Manual_of_Style|Memory Alpha]].''

The Tenth Fleet Wiki's '''Manual of Style''' is a collection of guidelines and rules of thumb that are designed to set a rough standard for the appearances of all articles. Although style is generally not considered the most important factor in the writing of an article, it ''is'' an important factor in the writing of good articles (or even [[TenthFleet:The Perfect Article|the perfect article]]). The manual of style is designed to make articles easier to read and comprehend, to make articles better organized and easier to edit.

Above all, realize that ''these rules are not set in stone!'' They are considered ''guidelines'' for making an article appear more attractive to the reader, to make them easier to work with. If you think you have a better way of writing an article, by all means go ahead and [[TenthFleet:Be bold in updating pages|be bold]]! Copy-editors will come along later and start the weeding process, and rework pages to better conform to the guide if necessary. Better yet, add your own idea [[~~TRMN~~ talk:Manual of Style|on this page]] as an additional option for adding style to an article. (However, please don't remove existing guidelines, just add your own new ones.)

Above all, realize that ''these rules are not set in stone!'' They are considered ''guidelines'' for making an article appear more attractive to the reader, to make them easier to work with. If you think you have a better way of writing an article, by all means go ahead and [[TenthFleet:Be bold in updating pages|be bold]]! Copy-editors will come along later and start the weeding process, and rework pages to better conform to the guide if necessary. Better yet, add your own idea [[TenthFleet talk:Manual of Style|on this page]] as an additional option for adding style to an article. (However, please don't remove existing guidelines, just add your own new ones.)

If you're looking for information on how to write an article in wiki markup, please see [[Help:Editing|how to edit a page]] for instructions. As that article is more about ''how'' to use markup, this article is concerned about the ''when'', ''where'', and ''why'' of using specific markup. Please also read the [[TenthFleet:Guide to layout|Guide to Layout]] for suggestions on how to ''organize'' your article.

Line 55:

Line 56:

The wiki engine will automatically create a table of contents based on the headers in an article.

In all cases, you should capitalize the first word and all proper nouns of the header, and leave all other words lowercase~~. The only place this does not apply is on episode and movie articles. These pages have their own unique format with all of the words capitalized~~.

In all cases, you should capitalize the first word and all proper nouns of the header, and leave all other words lowercase.

Avoid using links in headers. Depending on the browser's default settings, some users may not be able to see the links properly. It is much more useful to place the appropriate link in the first sentence after the header.

Line 111:

Line 112:

:Honor first appeared in the novel, "On Basilisk Station".

For uniformity and to avoid problems with the wiki software and the [[Help:Search|search]] utility, use '''straight''' quotation marks and apostrophes, and avoid curved marks such as the backtick or so-called "smart quotes". Punctuation marks should be placed inside of the quotation marks, unless the quotation marks surround a title (i.e., ~~episode~~, ~~comic~~, etc.), as shown in the third example above.

For uniformity and to avoid problems with the wiki software and the [[Help:Search|search]] utility, use '''straight''' quotation marks and apostrophes, and avoid curved marks such as the backtick or so-called "smart quotes". Punctuation marks should be placed inside of the quotation marks, unless the quotation marks surround a title (i.e., a novel, short story, etc.), as shown in the third example above.

==Citations==

Line 143:

Line 144:

Names that end in "s" or an "s"-sound should not have an "apostrophe s" ('s) added in the possessive form. Names that end in "x" or "z" should have an "apostrophe s" unless they are either silent or sound like an "s". For example, "Max" and should be "Max's" when using the possessive but "Sanchez" should be "Sanchez'''{{'}}'''" for the possessive.

== Disambiguation Pages ==

[https://en.wikipedia.org/wiki/Billet_(disambiguation) Example Disambiguation page for Billet]<br />

Referencing [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Disambiguation_pages Wikipedia's documentation] on '''Disambiguation pages''', the following layout structure has become a familiar format:

=== Page Naming ===

The page name should generally be named with the ambiguous term itself, unless there's a primary topic for that term.

=== At the top of the page ===

* Optional: link to term in [https://en.wiktionary.org/ Wiktionary]

* If a primary topic exists, a link to the primary topic

** A link back to the primary topic, in bold, should appear at the top, in a brief explanatory sentence.

* The introductory line (<nowiki><Ambiguous Term></nowiki> may also refer to:)

=== Individual entries ===

A list of entries which direct the reader to various individual pages similar to the disambiguation page's page name.

* Preface each individual entry with a ''bullet''

* Start each entry with a ''capital letter'', unless it specifically begins with a lowercase letter (eg iMac)

* Insert a ''comma'' after an entry when a description is included

* Use ''exactly one'' navigable (gold) link to direct the reader specifically to the single page the individual entry is there for

** Good example: * [[Maat]] - A junior non-commissioned officer in the Imperial Andermani Navy.

** Bad example: * [[Maat]] - A junior non-commissioned officer with the paygrade of [[E-4]] in the [[Imperial Andermani Navy]].

* Avoid descriptions that simply repeat information

** Good example: HMS Atropos (BC-363), the Homer-class battlecruiser assigned to the Third Fleet

** Bad example: HMS Atropos (BC-363), a ship in TRMN

* Keep the description associated with the link concise; just enough for the reader to differentiate between the individual ambiguous entries

=== Wikipedia Detailed Disambiguation Page info ===

* [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Disambiguation_pages Wikipedia:Manual of Style/Disambiguation_pages]

==See also==

Line 152:

Line 183:

* [[Help:Editing|How to edit a page]] is a basic introduction to wiki markup.

* [[TenthFleet:Naming conventions|Naming conventions]] is an article on how to properly name articles.

== External Links ==

* [https://en.wikipedia.org/wiki/Wikipedia:MediaWiki_order_of_page_names Wikipedia:MediaWiki order of page names]

[[Category:Wiki guidelines|Manual of Style]]

@@ Line 1: / Line 1: @@
+{{Editor handbook}}
 {{policy}}
 ::''The following Manual of Style is adapted from the document written and executed by [[memoryalpha:Memory_Alpha:Manual_of_Style|Memory Alpha]].''
 The Tenth Fleet Wiki's '''Manual of Style''' is a collection of guidelines and rules of thumb that are designed to set a rough standard for the appearances of all articles. Although style is generally not considered the most important factor in the writing of an article, it ''is'' an important factor in the writing of good articles (or even [[TenthFleet:The Perfect Article|the perfect article]]). The manual of style is designed to make articles easier to read and comprehend, to make articles better organized and easier to edit.
-Above all, realize that ''these rules are not set in stone!''  They are considered ''guidelines'' for making an article appear more attractive to the reader, to make them easier to work with. If you think you have a better way of writing an article, by all means go ahead and [[TenthFleet:Be bold in updating pages|be bold]]!  Copy-editors will come along later and start the weeding process, and rework pages to better conform to the guide if necessary. Better yet, add your own idea [[TRMN talk:Manual of Style|on this page]] as an additional option for adding style to an article. (However, please don't remove existing guidelines, just add your own new ones.)
+Above all, realize that ''these rules are not set in stone!''  They are considered ''guidelines'' for making an article appear more attractive to the reader, to make them easier to work with. If you think you have a better way of writing an article, by all means go ahead and [[TenthFleet:Be bold in updating pages|be bold]]!  Copy-editors will come along later and start the weeding process, and rework pages to better conform to the guide if necessary. Better yet, add your own idea [[TenthFleet talk:Manual of Style|on this page]] as an additional option for adding style to an article. (However, please don't remove existing guidelines, just add your own new ones.)
 If you're looking for information on how to write an article in wiki markup, please see [[Help:Editing|how to edit a page]] for instructions. As that article is more about ''how'' to use markup, this article is concerned about the ''when'', ''where'', and ''why'' of using specific markup. Please also read the [[TenthFleet:Guide to layout|Guide to Layout]] for suggestions on how to ''organize'' your article.
@@ Line 55: / Line 56: @@
 The wiki engine will automatically create a table of contents based on the headers in an article.
-In all cases, you should capitalize the first word and all proper nouns of the header, and leave all other words lowercase. The only place this does not apply is on episode and movie articles. These pages have their own unique format with all of the words capitalized.
+In all cases, you should capitalize the first word and all proper nouns of the header, and leave all other words lowercase.
 Avoid using links in headers. Depending on the browser's default settings, some users may not be able to see the links properly. It is much more useful to place the appropriate link in the first sentence after the header.
@@ Line 111: / Line 112: @@
 :Honor first appeared in the novel, "On Basilisk Station".
-For uniformity and to avoid problems with the wiki software and the [[Help:Search|search]] utility, use '''straight''' quotation marks and apostrophes, and avoid curved marks such as the backtick or so-called "smart quotes". Punctuation marks should be placed inside of the quotation marks, unless the quotation marks surround a title (i.e., episode, comic, etc.), as shown in the third example above.
+For uniformity and to avoid problems with the wiki software and the [[Help:Search|search]] utility, use '''straight''' quotation marks and apostrophes, and avoid curved marks such as the backtick or so-called "smart quotes". Punctuation marks should be placed inside of the quotation marks, unless the quotation marks surround a title (i.e., a novel, short story, etc.), as shown in the third example above.
 ==Citations==
@@ Line 143: / Line 144: @@
 Names that end in "s" or an "s"-sound should not have an "apostrophe s" ('s) added in the possessive form. Names that end in "x" or "z" should have an "apostrophe s" unless they are either silent or sound like an "s". For example, "Max" and should be "Max's" when using the possessive but "Sanchez" should be "Sanchez'''{{'}}'''" for the possessive.
+== Disambiguation Pages ==
+[https://en.wikipedia.org/wiki/Billet_(disambiguation) Example Disambiguation page for Billet]<br />
+Referencing [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Disambiguation_pages Wikipedia's documentation] on '''Disambiguation pages''', the following layout structure has become a familiar format:
+=== Page Naming ===
+The page name should generally be named with the ambiguous term itself, unless there's a primary topic for that term.
+=== At the top of the page ===
+* Optional: link to term in [https://en.wiktionary.org/ Wiktionary]
+* If a primary topic exists, a link to the primary topic
+** A link back to the primary topic, in bold, should appear at the top, in a brief explanatory sentence.
+* The introductory line (<nowiki><Ambiguous Term></nowiki> may also refer to:)
+=== Individual entries ===
+A list of entries which direct the reader to various individual pages similar to the disambiguation page's page name.
+* Preface each individual entry with a ''bullet''
+* Start each entry with a ''capital letter'', unless it specifically begins with a lowercase letter (eg iMac)
+* Insert a ''comma'' after an entry when a description is included
+* Use ''exactly one'' navigable (gold) link to direct the reader specifically to the single page the individual entry is there for
+** Good example: * [[Maat]] - A junior non-commissioned officer in the Imperial Andermani Navy.
+** Bad example: * [[Maat]] - A junior non-commissioned officer with the paygrade of [[E-4]] in the [[Imperial Andermani Navy]].
+* Avoid descriptions that simply repeat information
+** Good example: HMS Atropos (BC-363), the Homer-class battlecruiser assigned to the Third Fleet
+** Bad example: HMS Atropos (BC-363), a ship in TRMN
+* Keep the description associated with the link concise; just enough for the reader to differentiate between the individual ambiguous entries
+=== Wikipedia Detailed Disambiguation Page info ===
+* [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Disambiguation_pages Wikipedia:Manual of Style/Disambiguation_pages]
 ==See also==
@@ Line 152: / Line 183: @@
 * [[Help:Editing|How to edit a page]] is a basic introduction to wiki markup.
 * [[TenthFleet:Naming conventions|Naming conventions]] is an article on how to properly name articles.
+== External Links ==
+* [https://en.wikipedia.org/wiki/Wikipedia:MediaWiki_order_of_page_names Wikipedia:MediaWiki order of page names]
 [[Category:Wiki guidelines|Manual of Style]]

TenthFleet:Manual of Style: Difference between revisions

CMagnani (talk | contribs)