Difference between revisions of "The Dreadnought Project:Editing Guide"

From The Dreadnought Project
Jump to: navigation, search
(Article Names)
(Redirected page to Category:Editing Aids)
 
Line 1: Line 1:
Welcome to the '''Editing Guide''' for '''The Dreadnought Project'''.
+
#REDIRECT [[:Category:Editing Aids]]
 
+
==General Tips on Editing==
+
Editors who are new at editing in WikiText should bookmark [http://www.mediawiki.org/wiki/Help:Editing this page] and refer to it when they have questions on things such as making tables. 
+
 
+
Also, keep in mind that our own pages can be examined (by clicking "edit") and their own WikiText examined to provide quick examples. This, of course, will help keep you closer to our own customs of use, which are further detailed below.
+
 
+
==Conventions==
+
 
+
===Article Names===
+
 
+
====Ship Articles====
+
Individual ships are to be named where appropriate with the prefix first (e.g. H.M.S.), then the ship name, and then the year of launch in brackets.  For ships that were renamed at various points in their careers, the title should be their name at launch (you will see that we have not applied that in all cases)
+
 
+
'''Example''': [[H.M.S. Dreadnought (1906)]]
+
 
+
====Ship Class Articles====
+
Ship class pages are created by ignoring the prefix (classes are not referred to as the "U.S.S. ''Nevada'' Class Battleship"), using the name of the lead ship of the class, followed by the word "Class", and then the rough type name and year of launch for the earliest vessel of the class to be launched in brackets.  We use "Battleship" in lieu of "Dreadnought" and "Pre-Dreadnought", and try not to be overly precise in subtypes such as "Coastal Defence Battleship" or "Protected Cruiser". 
+
 
+
'''Example''': [[Danton Class Battleship (1909)]]
+
 
+
Classes that are denoted by a letter should have that letter in double quotes.
+
 
+
'''Example''': [["S" Class Destroyer (1918)]]
+
 
+
====Company Articles====
+
Company article titles should omit "Incorporated", "Limited", "Consolidated", etc, but these can be in the bold use of the company name at the head of the article.
+
 
+
Any leading "The" should be omitted from the title.
+
 
+
"and" should always be an ampersand when preceding "Sons", "Company" or when a pair of initials indicate multiple founders, e.g.:
+
 
+
* J. & W. Snickets
+
* Foobie & Company
+
* Father & Sons
+
 
+
===Device Names===
+
 
+
====Gun Calibres/Torpedo Diameters====
+
Due to its compactness, the suffix -in should be used to indicate "inches" of  measure.  -pdr will denote "pounder".
+
 
+
'''Examples''':
+
* 15-in gun
+
* 12-pdr gun
+
 
+
Metric measures should be abbreviated as cm or mm, without periods.
+
 
+
====Quantities of Numerically-named Items====
+
To foster clarity, the quantity of an item whose name starts with numbers should certainly be spelled out, and not expressed as an integer.
+
'''Example''':  Six 4-in guns
+
 
+
Editors can make exceptions for numbers with long names (i.e., over twenty)
+
 
+
====Awkward and Composite Units of Measure====
+
Unless quoting a passage or when the unit is part of a name, the editor should spare the reader from reaching for a dictionary and calculator.  If a gun is reported to weigh 4 cwt, 2 qt and 5 pounds, the weight should be recorded as "509 pounds".
+
 
+
====Fractions====
+
Unless a fraction is going to prove helpful in understanding something, editors are encouraged to use decimal equivalents.  There may be non-technical articles where the opposite practice may prove easier to read.
+
 
+
'''Example''': "4.5" rather than "4 <small><sup>1</sup></small>/<small><sub>2</sub></small>"
+
 
+
When a fraction may be helpful, you can avail yourself of the simplified <nowiki>{{Frac}} template.  e.g., {{Frac|3|4}} will display as </nowiki> "{{Frac|3|4}}"
+
 
+
====Patterns and Marks====
+
Although it may produce some unusual examples, the diverse and generally inconsistent placement of Mark and Pattern numbers in describing hardware prompts us to the standard that these should always be used as a suffix in creating article titles.
+
 
+
'''Examples''':
+
* [[Dreyer Table Mark III]]
+
* [[Torpedo Director Pattern 2006]]
+
 
+
===Ship Names===
+
Convention has it that ship names need to be highlighted in some way, and at '''The Dreadnought Project''' they are to be ''italicised''.  This applies to ''every'' ship name in ''every'' article.  It does not however, apply to article titles.
+
 
+
Note that almost every ship will have an automatically-generated template to refer to it, e.g., <nowiki>{{UK-Lion}}</nowiki>
+
 
+
For more on this practice, see [[:Category:ShipLink Templates|ShipLink Templates]].
+
 
+
===Class Names===
+
Conventions regarding the style of class names is less well documented.  On '''The Dreadnought Project''' the class name is to be italicised just like the ship name.  "Class" ought to be capitalised at the beginning.
+
 
+
'''Example''': [[Bellerophon Class Battleship (1907)|''Bellerophon'' Class]].
+
 
+
Ship class pages should always have the word "Class" in them.
+
 
+
===Offices===
+
When having a list of names of people who successively held tenures in an office, use the following conventions for the person's names.
+
* do not use prefix templates such as <nowiki>{{SIR}}, {{HON}}</nowiki>, but use the following forms:  "Sir", "Lord", "The Hon.", "The Rt. Hon.", "H.S.H."
+
* for suffixes, avoid most and abbreviate the remainder, e.g., ", Bart.".  Entirely omit decorations such as "C.B." and "D.S.O."
+
 
+
When such a list is in the form that FredBot ingests to make succession box data, make sure you've read the description of the [[Template:Tenure]]'s parameters.
+
 
+
===Article Leaders===
+
At the start of every article, the first mention of the subject of the article should be entered in '''bold'''; for example at the top of this page '''Editing Guide''' has been so highlighted.
+
 
+
====Ship Names====
+
Ship names should be in bold - as well as in italics.  The prefix will also be in bold.  e.g., '''S.M.S. ''Bayern'''''
+
 
+
====Personalities====
+
With persons who are the subject of an article (for the most part naval men), their rank and title should not be highlighted. e.g., Admiral of the Fleet '''John Rushworth Jellicoe''', First Earl Jellicoe
+
 
+
===Localisation===
+
American English is pervasive on the web, but TFS has a rich center (ooops... centre) in the ships, men and deeds of the Royal Navy, and is patterned after a storied British reference series, Jane's Fighting Ships.  As such, grammar and spelling should veer toward UK English rather than American English.  Some throwback words to the period might be nice, but don't overdo it. 
+
 
+
In some sections covering foreign navies, use of foreign languages and even character-based text might seem right and natural.  Such should be avoided unless the concept being discussed is truly different than something that can be described in English.  Extended and repeated use of foreign language, characters outside A-Z, etc hampers authors, readers and generally harshes the buzz.
+
 
+
===Turret Letters===
+
Unless quoting a written document, place the letter or number of a turret in double quotes, capitalised, e.g.,  "A" turret
+
 
+
===Lists and use of Periods/Full Stops===
+
Periods should not be used to end anything but a full sentence, particularly in a list.  We generally use periods in all acronyms, such as C.O.S. and T.S..  When ending a sentence, as in the previous one, after an acronym, double the period.
+
 
+
===Acronyms===
+
Acronyms should have periods within, no matter the pain caused.  e.g., H.M.S.,  C.O.S.,  T.C.T.,  B.L..  You will see that a fair number of these have templates defined to facilitate their use and to link to articles with an explanation, e..g.: 
+
* <nowiki>{{TS}}</nowiki>
+
* <nowiki>{{COS}}</nowiki>
+
* <nowiki>{{TCT}}</nowiki>
+
* <nowiki>{{GCT}}</nowiki>
+
 
+
Those sentences ending with an acronym should have a double period at the end. 
+
 
+
The contemporary practice of ending Roman numerals, as in Mark designations, with a period can be ignored.  e.g., "Torpedo Mark II" rather than "Torpedo Mark II."
+
 
+
===Article Footer===
+
Our convention is for every article to have the following sections at the bottom:
+
* See Also:  a list of links to closely related articles and external webpages (particularly, Wikipedia)
+
* Footnotes: where your references will be listed (see [[#Referencing]])
+
* Bibliography: a bullet list of valuable sources, often simply references to bibliographic templates
+
* a list of categories the article is a member of
+
 
+
Here is an example footer, as found in the article on the [[Dreyer Fire Control Table]]:
+
<nowiki>
+
 
+
==See Also==
+
{{refbegin}}
+
*[[Argo Clock]]
+
*[[Ford Rangekeeper]]
+
*[[Admiralty Fire Control Table]]
+
{{refend}}
+
 
+
==Footnotes==
+
{{reflist}}
+
 
+
==Bibliography==
+
{{refbegin}}
+
*{{UKDreyerTableHandbook1918}}
+
*{{UKDreyersFCSystemForLocalControl1913}}
+
*{{UKDreyerTableMarkIVRoyalOak1916}}
+
*{{UKPamphletDreyerTableMarkIII*1930}}
+
*{{UKPamphletDreyerTableMarkIV*1930}}
+
*{{UKPamphletDreyerTableMarkV1930}}
+
*{{UKPamphletDreyerTurretTable1930}}
+
{{refend}}
+
 
+
[[Category:Fire Control]]
+
[[Category:Shipboard Equipment]]
+
</nowiki>
+
 
+
==Referencing==
+
Articles on '''The Dreadnought Project''' should be well-referenced or marked clearly by the <nowiki>{{CN}}</nowiki> template to indicate that the referencing should be completed and soon.  Referencing is easily accomplished.
+
 
+
Before using longhand "refs", check whether your source is one of the many for which we have a [[::Category:Citable Source Templates|Citable Source Template]], which greatly reduces typing.  If your work is not so
+
 
+
Footnotes should be placed after any punctuation (full stop/period or comma for example) that follows the statement to be cited.  For example:
+
 
+
:<nowiki>''Iron Duke's'' pendant number from April, 1918 to the armistice was 14.{{DittColl|p. 33}}</nowiki>
+
 
+
==See Also==
+
* [[:Category:Citable Source Templates]] help us cite sources breezily
+
* [[:Category:ShipLink Templates]] help us quickly refer to any ship
+
 
+
[[Category:Editing Aids]]
+

Latest revision as of 09:35, 18 October 2018