Battlestar Wiki:Standards and Conventions: Difference between revisions
More languages
More actions
m →Disambiguations: tweak |
+ overview section header |
||
Line 8: | Line 8: | ||
This set of pages are '''not''' designed to supersede other [[Battlestar Wiki:Project List|project]]s or [[Battlestar Wiki:Policy|policies]]. Some overlap is expected, but project-specific standards and conventions should be moved to their project page, if one exists or a page created for a project, if one does not. | This set of pages are '''not''' designed to supersede other [[Battlestar Wiki:Project List|project]]s or [[Battlestar Wiki:Policy|policies]]. Some overlap is expected, but project-specific standards and conventions should be moved to their project page, if one exists or a page created for a project, if one does not. | ||
== Overview == | |||
Here is an overview of the standards and conventions sections. | Here is an overview of the standards and conventions sections. |
Revision as of 23:17, 15 April 2008
| |||||
Battlestar Wiki Policy |
---|
Article Standards |
Article Standards & Conventions |
Sysop ← Interaction → User |
Site Wide |
Deletion |
Guidelines |
Inactive Policies |
Razor Material |
This page serves as the central hub for standards used in writing articles on Battlestar Wiki. Discussion on new or established standards and conventions listed in this section should be discussed on the talk page.
This set of pages are not designed to supersede other projects or policies. Some overlap is expected, but project-specific standards and conventions should be moved to their project page, if one exists or a page created for a project, if one does not.
Overview
Here is an overview of the standards and conventions sections.
- Page Formatting: This covers our preferences on Wiki syntax over HTML, in addition to how to format images and categories.
- Article Prose and Grammar: Discusses our use of present tense for a majority of our articles, as well as how to properly format titles, using names vs. callsigns, etc.
- Cast and Crew Biographies: Covers how to write and format a biographical article on cast, crew, and people involved with the various series.
- Episode Guides: Tackles what an analysis and questions section of our episode guides should look like.
- Disambiguations: Tackles why those pesky little "(TOS)" and "(RDM)" suffixes are added to article names, as well as how to properly format a disambiguation page.
- Quote of the Day pages: Tackles how to properly format a quote page for the "Quote of the Day" feature.
Summary of Standards and Conventions
This is the Cliff Notes version of our Standards and Conventions guidelines for your convenience. While they are explained in more detail in the subpages, most people will not want to use their time reading through them (despite the fact that we've made them as concise as possible). Still, here we go...
Formatting
- Main article: Battlestar Wiki:Standards and Conventions/Formatting
Markup
- Always use Wiki code instead of HTML code, unless the Wiki code equivalent does not exist.
- NEVER use: <b> for bold face, <i> for italics, <a href> for links, <img> for images.
- Exception: There is presently no wiki code for underlining text, so one would use <u>text to be underlined</u>. Further, to center text on pages, you will have to use <div align="center">text to be centered</div>.
Images and Audio Content
- Avoid burdening down a page with pictures. Use only pictures whenever necessary to illustrate the subject. Each picture must have a reason for use under the fair use clause of United States' copyright law.
- Image galleries are limited to unique pages, like articles on rooms of a ship (i.e. Combat Information Center) and pages on ships, like Galactica.
- Audio files should only be used for illustrative purposes where pictures fail to be illustrative (i.e. Case Orange, Action stations) and for noteworthy quotes on episode guides.
Categorization of Articles
- All pages, with the exception of disambiguation pages, are to be categorized using our category system.
- All articles should go into the A to Z category.
- Series related categories (Category:TOS, Category:RDM, and Category:1980) are to be the last category in the category list on a page.
- Articles are never to be sorted by articles ("the", "and", "or") or by first names.
- The {{DEFAULTSORT:}} syntax is always to be used to declare a sort key for category listings.
- In extreme circumstances, this may be overridden by declaring the sort key in the syntax of select categories, example of a category syntax from Battlestar Galactica (RDM): [[Category:RDM|*]]. The "|*" allows the article to come before the alphabetical listings, so that it is the most visible.
Linking to Episodes
- When linking to episodes, always link the first instance of the episode name per section. Beyond that, do not overlink episode titles.
- As for how to refer to episodes within an article:
- When referring to episode titles as part of the sentence, always include the episode name in quotation marks:
- When citing a single episode title as a source for a body of text, use parentheses, but do not place quotes around the episode name.
- Example: "Galactica finds Pegasus (Pegasus)."
- When citing multiple episode titles as a source for a body of text, place all episode names within one set of parentheses. Each episode title should use commas to separate them within the parentheticals.
- Example: Lee Adama is moody often (Miniseries, "33", "Water", "The Hand of God").
- Major exception: The term Miniseries should never be placed in quotations, since this is not the technical name of the pilot. (The Re-imagined Series' pilot is simply called "Battlestar Galactica".)
- Second exception: When writing episode titles and book titles, the comma should always go after the quotation mark, never before it.
Red Links
- Red links should either be corrected to point to the proper article on the intended subject, or submitted with the {{requested}} tag.
Prose and Grammar
- Main article: Battlestar Wiki:Standards and Conventions/Prose
Spelling and Numeric Notation
- American English spellings are default. British English spellings are allowed by users familiar with that language, but expected your edits to be converted into American English. (i.e. "colour" will be converted to "color", etc.)
- Numbers should use commas ( , ) to mark every three digits, and decimal points ( . ) to denote numbers with decimals.
- Numbers less than 11 should be spelled out, "five" for "5", etc.
- Any proper nouns with numbers should be written out without Arabic numerals, this includes Colonial One and The Twelve Colonies.
- The exception to this are Vipers or Raptors identified by numerics, i.e. Viper 8757 or Raptor 1.
- Use an apostrophe-S ('s) for all possessives, unless the noun is plural.
- "Pegasus's fuel reserves are low." (singular
- "The Vipers' ammunition would not fire." (plural possessive)
Characters Names and Titles
- When first introducing a character, always introduce them by their first and last names.
- In text, characters should always be referred to by their last names.
- First Exception: Characters sharing the same last name, like Saul Tigh and Ellen Tigh, or William Adama and Lee Adama, may be referred to by their first names or by their rank, if applicable, and last name (Commander Adama for William Adama, Captain Adama for Lee Adama).
- Second Exception: Articles on one of the aforementioned subjects, such as William Adama, should always be refer to the subject by their last name. Subjects sharing the same last name may be referred to their first name, after being introduced in said article by their full name.
- Members of the Quorum of Twelve should always be referred to as "delegates", not "representatives".
- Characters should not be referred to by their rank exclusively or by nicknames. For instance, when writing an article, William Adama should never be referred to as "the Old Man" or "the Commander".
- For characters with both callsigns and proper names, like Apollo/Lee Adama, Hot Dog/Brendan Costanza or Kat/Louanne Katraine, always refer to these characters by their last names.
Titles for episodes, movies, books and shows
- When citing a television episode, use quotations (i.e. "Valley of Darkness") most of the time. Click here for the exception.
- When referring to a book by its name, use italics (i.e. Battlestar Galactica: The Official Companion).
- When referring to the television series itself, use italics (i.e. [[Battlestar Galactica, Galactica 1980).
Tense
- All articles are to be written in the present tense, unless:
- The article occurs before the "Event Zero" of a continuity. "Event Zero" is defined by the following:
- For the original series, anything happening before the events depicted in "Saga of a Star World" should be written in past tense.
- For Galactica 1980, anything happening before the events depicted in "Galactica Discovers Earth, Part I" should be written in past tense. The only exception for this is "The Return of Starbuck", which is mostly a flashback episode, but most of the events should be written in the present tense.
- The article occurs before the "Event Zero" of a continuity. "Event Zero" is defined by the following:
- As for the Re-imagined Series, anything happening before the events depicted in the Miniseries should be written in the past tense. However, this is where things get interesting:
- If an article is exclusively about Caprica (which occurs roughly 50 years before the Miniseries'), then it should be written in present tense. The same applies for articles exclusively about the Re-imagined Series.
- If an article spans from Caprica to the Re-imagined Series, then:
- Events occurring before the Miniseries (timeline-wise) should be written in the past tense.
- Events occurring during and after the Miniseries (timeline-wise) should be written in the present tense.
About Signatures...
- Signatures are to be used exclusively on talk pages. If the title of the page you're editing does not have "talk" in its name, do not add your name or timestamp to it.
- The only exceptions to this are: the Chiefs' noticeboard, the Battlestar Wiki:Galactipedians Quorum, the Think Tank and a few others.
- In short, never sign articles!
Biographies on Cast, Crew, and People
- Main article: Battlestar Wiki:Standards and Conventions/Biographies
- The lead sentence or paragraph introduces the reader to the subject matter. It includes, the person's full name, date of birth and death, nationality, role in the series' and other appearances that the person is notable for.
- The article's tense is determined by whether the subject is presently alive or deceased. If alive, everything is written in present tense; if deceased, everything is written in past tense.
- Always refer to the subject by their last name.
- Articles of reasonable length should be sectioned off, and typically written in this order: Childhood, Early career, Work on Battlestar Galactica, and Later career.
- Articles with time sensitive information should be written with care. Always specify when the event is to occur, and never use vague words like "currently", "most recently", "presently", "this year" or "latest". Instead, use "as of [this date], such and such is to occur".
Episode Guides
- Main article: Battlestar Wiki:Standards and Conventions/Episode Guides
- Should always be written in the present tense. Also, all parts of the episode page are to be sectioned, even the "overview" portion.
- The summary section, unless there are (at least) two distinct non-overlapping storylines, should always be in Act 1, Act 2, etc. header formats. Bonus scenes should also in their own header.
- Episode guides should never argue with itself. Any "arguing" should be hashed out on the corresponding talk pages.
- When in doubt about any piece of content, always bring it up on a talk page.
Questions
- The questions section should be for questions that are raised by the episode, but not answered within said episode.
- Questions that are answered in a subsequent episode should also have a link to said episode where that question is answered.
- Example: Why do the Cylons want to keep Karl Agathon on Caprica? (Answer 1, Answer 2)
- Questions should never be debated on the episode guide page. Questions should always be questioned and discussed on the corresponding talk page.
Notes and Analysis
- Any questions that are raised, and subsequently answered within the same episode, are typically placed in the analysis section.
- The different between "Notes" and "Analysis": notes are for information that require no further explanation or plausible speculation, whereas analysis is content that requires digging into the meat of the series and explaining contradictions, plot evolutions, and other content that requires critical thinking.
Disambiguations
- Disambiguations are navigational aids that help direct people to articles on specific subjects that share the same names, since many of the Battlestar Galactica series use the same names. Disambiguations come in two forms: a page (such as Adama), and in the form of an acronym within parentheses tacked on an article name (such as Adama (TOS)).
- Disambiguations within parentheses are as follows:
- (TOS) - Original Series
- (1980) - Galactica 1980
- (RDM) - Re-imagined Series & Caprica
- (2003 Video Game) - 2003 Video Game
- (2007 Video Game) - 2007 Video Game
- (SDS) - Ill-fated Singer/DeSanto continuation project
- (TSC) - Richard Hatch's "Second Coming" attempt
- To refer to either the 1978 series or the 2003 series within the body of an article, the proper nouns are acceptable: Original Series and Re-imagined Series.
- Due to the popularity of the new series, as well as the volume of articles related to the Re-imagined Series, the use of the link [[Galactica]] will lead to the Galactica (RDM) article on the new series' battlestar. A disambiguation header always appears on this article for the two other ship articles on Galactica. The same is true for Pegasus.
- Disambiguation pages themselves have a unique format, consisting of:
- An introductory sentence introducing that the following articles share the same name, with the disambiguated term boldfaced.
- This is to be followed by one-sentence bullet points about each article that shares that name, ending in a full stop (i.e. a period).
- If necessary, section off the bullet point lists by series or, failing that, by a unique classification.
- After the bullet points are completed, the page is ended with the {{disambig}} template.
- Disambiguation pages are not categorized.
Quotes of the Day
- Quotes of the Day have their own format, as well as their own namespace (named "Quotes"). Such as Quotes:09 17, with the two digit month and date after the colon.
- Quotes that are one-line or one-paragraph in length should be formatted like so:
- "Ladies and gentlemen, please. Please. We are in a laboratory. There are hazardous chemical compounds everywhere. That--that's a thermo-nuclear bomb, for frak's sake, so..."
- --Dr. Gaius Baltar (Tigh Me Up, Tigh Me Down)
- "Ladies and gentlemen, please. Please. We are in a laboratory. There are hazardous chemical compounds everywhere. That--that's a thermo-nuclear bomb, for frak's sake, so..."
- Quotes that consist of two or more paragraphs of dialogue:
- Captain Lee Adama: Hey, how about you, Boomer? Doc tells me you're holding up better than anybody in the squadron.<br\>
- Lieutenant Sharon Valerii: I'm tired, like everybody else.<br\>
- Adama: You never seem it.<br\>
- Lieutenant Kara Thrace: 'Cause she's a Cylon.<br\>
- Valerii: You're just gonna make me come over there and kick your ass, aren't you?<br\>
- --33
- Each new line should have a <br\> tacked at the end, with the exception of the last line.