Difference between revisions of "Help: Manual of Style"

From A Wiki of Ice and Fire
Jump to: navigation, search
(Dates and Years)
(Expand on spoiler prevention and section layout)
Line 4: Line 4:
 
* Use the '''Preview''' button.
 
* Use the '''Preview''' button.
 
* Follow the format of existing pages as much as possible, you can always use the [[Sandbox|sandbox]] to test code.
 
* Follow the format of existing pages as much as possible, you can always use the [[Sandbox|sandbox]] to test code.
* Add a descriptive summary when [[Help:Editing pages|editing a page]], A "minor edit" is a fix to a typo or small change that does not affect the page.  No summary required.
+
* Add a descriptive summary when [[Help:Editing pages|editing a page]]. A "minor edit" is a fix to a typo or small change that does not affect the page, with no summary required.
  
 
===Discussion===
 
===Discussion===
* Sign your name at the end of your post by adding 4 tildes (<nowiki>~~~~</nowiki>)
+
* Sign your name at the end of your post by adding four tildes (<nowiki>~~~~</nowiki>).
 
* Indent your post with a colon (:) when replying to a previous post.
 
* Indent your post with a colon (:) when replying to a previous post.
  
 
===Dates and Years===
 
===Dates and Years===
* Use <code><nowiki>[[300AC|300AC]]</nowiki></code> when linking to years after [[Aegon's Landing]]. There are templates that automate this: <code><nowiki>{{Date|300}}</nowiki></code>
+
* Use <code><nowiki>[[300 AC]]</nowiki></code> when linking to years after [[Aegon's Landing]]. [[Template:Date]] automates the process; <code><nowiki>{{Date|300}}</nowiki></code> links to [[300 AC]]. Links to years before Aegon's Landing can be presented with <code><nowiki>[[Years before Aegon's Conquest|2 BC]]</nowiki></code>, which links to [[Years before Aegon's Conquest]].
  
 
===Punctuation===
 
===Punctuation===
Line 25: Line 25:
  
 
==Article layout==
 
==Article layout==
An article should begin with an introductory lead section, that provide an overview of the topic, briefly summarizing the article for the reader. Followed by the rest of the article divided into sections, each with a section heading. If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead and the first heading.
+
An article should begin with an introductory lead section which summarizes the subject's status when it is introduced in the story. It is followed by the rest of the article divided into sections, each with a section heading. If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead and the first heading. As a form of spoiler protection, plot details from the books should be presented in a chronological context through the "Recent Events" section.<ref>[[User:Ran]], [http://asoiaf.westeros.org/index.php/topic/34958-the-asoiaf-wiki-thread/page-9#entry2217375 forum post].</ref><ref>[[User:Ran]], [http://asoiaf.westeros.org/index.php/topic/45165-grammar/?p=2217445 forum post].</ref>
  
 
===Introduction===
 
===Introduction===
 
* The first occurrence of the [name of the] subject of the article at first mention must be bolded, preferably in the first sentence in the article.
 
* The first occurrence of the [name of the] subject of the article at first mention must be bolded, preferably in the first sentence in the article.
* ( The lead section should be about one to three paragraphs long, dependent on the overall size of the article. Often, a single sentence suffices.
+
* The lead section should be about one to three paragraphs long, dependent on the overall size of the article. Often, a single sentence suffices.
* Ideally, the lead section should be a synopsis of the topic's history, role and significance.
+
* Ideally, the lead section should describe the status of the topic when it is first introduced by [[George R. R. Martin]]. Spoilers should not be included in the lead.
  
 
===Body===
 
===Body===
* For the "Genealogy" section, use the [[Template:Familytree|familytree template]].
+
* The physical appearance and personalities of characters can be described in an "Appearance and Character" section.
* "Recent events" section  
+
* General history (pre-''[[A Song of Ice and Fire]]'') should be described in the past tense in a "History" section. Some historical information, such as revelations in [[A Storm of Swords-Chapter 80|''A Storm of Swords''-Chapter 80]] or [[A Dance with Dragons-Chapter 13|''A Dance with Dragons''-Chapter 13]], is used by George R. R. Martin for drama instead of [[w:worldbuilding|worldbuilding]]. These major spoilers can instead be presented within the "Recent Events" section.
* "See Also" is a section where the reader can be pointed at related articles, or a gallery of images of the subject.
+
* Plot from the novels of ''A Song of Ice and Fire'' should be presented chronologically and in the present tense in a "Recent Events" section. This should be subdivided by book (''A Game of Thrones'', ''A Clash of Kings'', ''A Storm of Swords'', ''A Feast for Crows'', ''A Dance with Dragons'', ''The Winds of Winter''). This allows the reader of an article to follow along according to how far in the books they have read without being spoiled by books they have yet to read. To prevent spoilers in the "History" section, "Recent Events" can also include a [[POV character]]'s revelations regarding major events which occurred before ''A Song of Ice and Fire''.
 +
* For the "Genealogy" section, use [[Template:Familytree]].
 +
* "See Also" is a section where the reader can be find related articles, or a gallery of images of the subject. If a related topic has already been linked to earlier in the article, it should generally not be included in the "See Also" section.
  
 
===Links===
 
===Links===
The following should be [[Help:Links|link]]: dates, places, people, events etc everything that appears in a narrative this wiki [[Help:Referencing and Canon|covers]]. However, don't over link, it is recommended that you limit the number of times you link the same word in a single article, Generally, it is preferred that you link to only the first instance of a word in each section of an article. If the article is not sectionalised, but has large, multi-sentence paragraphs, then link the word once a paragraph. If you have made a link in captions or the infobox, it is a good idea to make the same link in the article.
+
Everything that appears in a narrative this wiki [[Help:Referencing and Canon|covers]] may be [[Help:Links|linked]], such as dates, places, people, and events. However, do not over link; it is recommended that you limit the number of times you link the same topic in a single article. Generally, it is preferred that you link only the first instance of a topic in each section of an article. If you have made a link in captions or the infobox, it is a good idea to make the same link in the article.
  
Do not use external links in the body of an article. Articles can include an external links section at the end as further reading, the following sites should be linked: Official sites (that majorly relate to the topic), articles about the subject of article on other encyclopedias or vast resources that contain neutral and accurate information that has not been mentioned in the article.
+
Do not use external links in the body of an article. Articles can include an external links section at the end as further reading. The following sites can be linked: official sites that relate to the topic, articles about the subject of article on other encyclopedias, or vast resources that contain neutral and accurate information that has not been mentioned in the article.
  
 
===References===
 
===References===
Line 49: Line 51:
 
==Sources and Copying==
 
==Sources and Copying==
 
Information for the content of pages comes from a lot of different sources. If the source of your contributions is something other than the books, please state your sources. <br>
 
Information for the content of pages comes from a lot of different sources. If the source of your contributions is something other than the books, please state your sources. <br>
Copying from wikipedia is okay; the content of wikipedia is free but there are some rules, which are stated in our [[Help:Attribution|attribution help page]].  
+
Copying from Wikipedia is okay; the content of Wikipedia is free but there are some rules, which are stated in our [[Help:Attribution|attribution help page]].  
 
In short you have to refer to the original article. This is a must!  
 
In short you have to refer to the original article. This is a must!  
* A good way to do this is using the template <nowiki>{{EnWP|<article from wikipedia>}}</nowiki>
+
* A good way to do this is using the template <nowiki>{{EnWP|<article from Wikipedia>}}</nowiki>
  
 
==Images==
 
==Images==
* Uploaded images must be related to [[A Song of Ice and Fire]] and its derivative works, the one exception being if you want to upload an image for your userpage, of yourself or for a [[:Category:Userboxes|userbox]].
+
* Uploaded images must be related to ''[[A Song of Ice and Fire]]'' and its derivative works, the one exception being if you want to upload an image for your userpage, of yourself or for a [[:Category:Userboxes|userbox]].
* Always tag the images you're uploading with copyright information; for this you can use [[Template:copyright tags|copyright tags]] template.
+
* Always tag the images you are uploading with copyright information; for this you can use [[Template:copyright tags|copyright tags]] template.
* It's preferred that any primary image used (be it a photo or an artistic depiction) is one that does not deviate too much from how the character is described. <ref>[[User:Linda]], [http://asoiaf.westeros.org/index.php/topic/50947-for-some-reason-this-really-annoys-me/page__view__findpost__p__2681674 forum post].</ref>
+
* It is preferred that any primary image used (be it a photo or an artistic depiction) is one that does not deviate too much from how the character is described.<ref>[[User:Linda]], [http://asoiaf.westeros.org/index.php/topic/50947-for-some-reason-this-really-annoys-me/page__view__findpost__p__2681674 forum post].</ref>
  
 
* When [[Help:Images|uploading images]] to the Wiki, the rule of the thumb is to use JPEG for photographic images, and PNG for everything else.
 
* When [[Help:Images|uploading images]] to the Wiki, the rule of the thumb is to use JPEG for photographic images, and PNG for everything else.
Line 72: Line 74:
 
{{references}}
 
{{references}}
 
{{wikiHelpNav}}
 
{{wikiHelpNav}}
 +
 
[[Category:Editing_Resources]]
 
[[Category:Editing_Resources]]
 
[[Category:Help]]
 
[[Category:Help]]

Revision as of 22:18, 23 February 2015

This Manual of Style is a collection of rules of thumb and guidelines for giving our wiki a consistent look and feel. It is intended as a handy reference for editors. Feel free to suggest or discuss guidelines, over at the forum or on the discussion tab.

General rules

  • Use the Preview button.
  • Follow the format of existing pages as much as possible, you can always use the sandbox to test code.
  • Add a descriptive summary when editing a page. A "minor edit" is a fix to a typo or small change that does not affect the page, with no summary required.

Discussion

  • Sign your name at the end of your post by adding four tildes (~~~~).
  • Indent your post with a colon (:) when replying to a previous post.

Dates and Years

Punctuation

  • For quotations, use "double quotes" and 'single quotes' for nesting quotations; thus "quotations 'within' quotations".
  • Write formally. Avoid using contractions such as don't, can't, won't, would've, or they'd.
  • Avoid using slashes to join words. Instead, spell it out.

Tense

  • Articles that cover events taking place before the novels should be written in past tense. However, events taking place in the book series should utilize present tense - even if the event is outdated by new books in the series.

Spelling

  • Words should be spelled using the American English spelling.

Article layout

An article should begin with an introductory lead section which summarizes the subject's status when it is introduced in the story. It is followed by the rest of the article divided into sections, each with a section heading. If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead and the first heading. As a form of spoiler protection, plot details from the books should be presented in a chronological context through the "Recent Events" section.[1][2]

Introduction

  • The first occurrence of the [name of the] subject of the article at first mention must be bolded, preferably in the first sentence in the article.
  • The lead section should be about one to three paragraphs long, dependent on the overall size of the article. Often, a single sentence suffices.
  • Ideally, the lead section should describe the status of the topic when it is first introduced by George R. R. Martin. Spoilers should not be included in the lead.

Body

  • The physical appearance and personalities of characters can be described in an "Appearance and Character" section.
  • General history (pre-A Song of Ice and Fire) should be described in the past tense in a "History" section. Some historical information, such as revelations in A Storm of Swords-Chapter 80 or A Dance with Dragons-Chapter 13, is used by George R. R. Martin for drama instead of worldbuilding. These major spoilers can instead be presented within the "Recent Events" section.
  • Plot from the novels of A Song of Ice and Fire should be presented chronologically and in the present tense in a "Recent Events" section. This should be subdivided by book (A Game of Thrones, A Clash of Kings, A Storm of Swords, A Feast for Crows, A Dance with Dragons, The Winds of Winter). This allows the reader of an article to follow along according to how far in the books they have read without being spoiled by books they have yet to read. To prevent spoilers in the "History" section, "Recent Events" can also include a POV character's revelations regarding major events which occurred before A Song of Ice and Fire.
  • For the "Genealogy" section, use Template:Familytree.
  • "See Also" is a section where the reader can be find related articles, or a gallery of images of the subject. If a related topic has already been linked to earlier in the article, it should generally not be included in the "See Also" section.

Links

Everything that appears in a narrative this wiki covers may be linked, such as dates, places, people, and events. However, do not over link; it is recommended that you limit the number of times you link the same topic in a single article. Generally, it is preferred that you link only the first instance of a topic in each section of an article. If you have made a link in captions or the infobox, it is a good idea to make the same link in the article.

Do not use external links in the body of an article. Articles can include an external links section at the end as further reading. The following sites can be linked: official sites that relate to the topic, articles about the subject of article on other encyclopedias, or vast resources that contain neutral and accurate information that has not been mentioned in the article.

References

  • For all articles, notes and references/sources are combined under the same subsection: References. For this, simply type {{references}} at the bottom.
  • Cite only sources that are considered Canon and reliable sources like Concordance. Do not cite secondary sources unless there are valid conclusions drawn based on the previous.

Sources and Copying

Information for the content of pages comes from a lot of different sources. If the source of your contributions is something other than the books, please state your sources.
Copying from Wikipedia is okay; the content of Wikipedia is free but there are some rules, which are stated in our attribution help page. In short you have to refer to the original article. This is a must!

  • A good way to do this is using the template {{EnWP|<article from Wikipedia>}}

Images

  • Uploaded images must be related to A Song of Ice and Fire and its derivative works, the one exception being if you want to upload an image for your userpage, of yourself or for a userbox.
  • Always tag the images you are uploading with copyright information; for this you can use copyright tags template.
  • It is preferred that any primary image used (be it a photo or an artistic depiction) is one that does not deviate too much from how the character is described.[3]
  • When uploading images to the Wiki, the rule of the thumb is to use JPEG for photographic images, and PNG for everything else.
  • Superseded or replaced images should be kept to preserve Wiki historical record. Deletion, should only be used in case of copyright violation or technical reasons.
  • You should always be watchful not to overwhelm an article with images by adding more just because you can.


Categories & Templates

  • Each page and each image should be labeled with a category or more if appropriate. You can use the Categories Overview to find out more on how they are organized.
  • You can find a list of templates here: Category:Templates and an overview of the most common ones here:Help:Templates Overview. Many of the Templates used in the wiki automatically tag the pages with the appropriate category.

Notes