RRU Knowledge Base:Guidelines

This article is an unfinished work in progress or contains transferred information that needs to be rewritten or reformatted to fit our standards. Please excuse the mess and do not mark for deletion.

Any good programmer will tell you that one of the best things you can do for yourself and others is to have a consistent, nicely formatting code style to abide by. In the same manner, a wiki should be written using consistent formatting and alike writing style, so as it would appear as if it has been written by a single author.

For the rest of this article, I will be taking you through some of the RRU Knowledge Base writing guidelines. These guidelines are in place to improve your writing and the wiki as a whole, not hinder it. Some of these guidelines should be kept at all times, while others are strongly recommended. This difference will be noted when applicable. :)

Feel free to expand this heavily by ripping off (though preferably rewriting in our own words) Wikipedia's MOS and specifying things as thoroughly as they do - though keep in mind our rules are different, since we are not as purely encyclopedic as they are.

General Guidelines

Bias & Opinion

Be objective when writing. Do not include person preference, opinion, or bias when writing. If you disagree about something on a page, use its talk page to discuss and debate it. Do not start an edit war by persistently adding your opinion to the page. Opinions are allowed on your user profile, however.

Modernization

This wiki is meant to escape the traditional look of traditional wikis and use better design and web standards.

Those who cannot write English well should use an automatic translator such as Google Translate to convert writing to English. Other users can then improve any issues with the translation.

hidden stuff from guideline page about how to structure the wiki, don't remember exactly how you wanted it and better explanations are needed for some things i think:

Structure and formatting

Repetitive linking

An article should only be linked to the first time it is mentioned on a page, and the first mention should always be linked. Additional links may be allowed if there is a lot of content between each link, or if it's crucial to something being explained further down the page — e.g. list in the middle of a page, or an exceptionally long page.

Sections

Do not use = Level 1 = sections.

  1. Before the lead section
    1. Hatnotes
    2. Deletion/Protection tags
    3. Maintenance/dispute tags
    4. Infoboxes (??? - copied from wikipedia)
    5. Foreign character warning boxes (??? - copied from wikipedia)(we've got them on so many pages though)
    6. Images
    7. Navigational boxes (header navboxes) (??? - copied from wikipedia)
  2. Body
    1. Lead section (also called the introduction)
    2. Table of contents (on our current skin)
    3. Content
  3. Appendices[1]
    1. Works or publications (for biographies only)
    2. Gallery
    3. See also
    4. Notes
    5. References (Citations/Footnotes, Bibliography/Sources)
    6. Further reading (may or may not be a sub-section of References)
    7. External links
  4. Bottom matter
    1. Categories
    2. Stub template

Writing style

Perspective

Always write in third person perspective. This means you should not use personal pronouns such as I, me, and myself. Do not refer directly to the reader in articles, though guides may be exempt from this rule.

English varieties

American and British English are both acceptable, however consistency within an article should be maintained. Articles originally written in American English should remain as such and not mixed with British English varieties of words. Any additions to an article should continue using the same English variety. Create redirects for alternative English title renderings to one main article. For example: Color redirects to the Colour article or vise versa. This will prevent searches using one English variety returning zero results.

However, considering how heavily we focus on Lego video games, and how they were all developed by British companies, might that affect our preferences?

Capitalization

Proper capitalization rules should always be followed in standard writing. Do Not Write Sentences Like This. nor leave sentences uncapitalized like this.

Proper names

Names of vehicles and buildings should be capitalised on a case-by-case basis. However, the names of objects and creatures, unless using a proper name in their name, should generally not be capitalised. For instance, "rock monster" should usually not be written as "Rock Monster", despite most LEGO media writing it this way.
For now, brand names should be written with their stylized capitalization – LEGO instead of Lego, despite Wikipdia following different rules.
Code should be left in its original capitalization.

Italic type

Italic type (text like this) is produced by placing double apostrophes on either side of the content to be italicized ''like this''. If the title of an article is or contains a name or phrase that should be italicized, place {{Italic title}} at the top of the page to display the article's title in italics. If only part of the article's title needs to be italicized, add the article's exact title as a parameter, placing double apostrophes around the italicized part: {{Italic title|''Italicized part'' and non-italicized part}}.

Emphasis

Italicize emphasized words by using the HTML emphasis markup <em>...</em> or the template {{em|...}}. This allows it to be parsed and acted upon in customizable ways with style sheets, apps and text-to-speech screen readers.

Titles of major works

The titles of major works should always be italicized. This includes:

  • Audio albums
  • Books, multi-volume works (e.g. encyclopedia sets), and booklets, but not major religious works.
  • Comic books, comic strips, graphic novels and manga
  • Non-generic names of major independent compositions
  • Court case names, but not case citation or law report details included with the case name
  • Named exhibitions (artistic, historical, scientific, educational, cultural, literary, etc. – generally hosted by, or part of, an existing institution such as a museum or gallery), but not large-scale exhibition events or individual exhibits
  • Films (including short films) and documentaries
  • Paintings, sculptures and other works of visual art with a title rather than a name
  • Periodicals (newspapers, journals, magazines)
  • Plays (including published screenplays and teleplays)
  • Long or epic poems
  • Officially named series of major works
  • Syndicated columns and other features republished regularly by others
  • Television and radio programs, specials, shows, series and serials
  • Video games (but not other software)

Other uses

  • Names of ships, e.g. LMS Explorer
  • Taxonomic names written in Binomial nomenclature, e.g. Tyrannosaurus rex
  • Mentioning words, characters, or strings of words up to one full sentence
  • Mentioning foreign words and phrases

Vocabulary

Contractions

Avoid using contractions whenever possible. If the contraction can't be expanded without sounding awkward, the sentence containing it should be rewritten to sound better.

Slang, jargon, and expletives

Do not use slang, jargon, cursing, or any other form of unprofessional writing. Though this may ultimately be a site about products primarily targeted at children, we still strive for a professional presentation. Additionally, for the aforementioned reason, articles should be kept family-friendly as much as possible.

Gender-neutral language

Use gender-neutral language when possible. Do not use terms such as "he or she" or the generic he when referring to an unspecified or unknown person or audience; use singular they in these cases instead.

References and citation

Documentation

Documented code should be written in tables. The code should go on the left, and the description on the right.

Files

  • Use the PNG image format when possible. PNG images are generally of much quality than JPG images.
  • If a replaceable screenshot is in JPG format or in low quality, please replace it with a lossless high-quality screenshot.

Mods

  • When uploading images related to your mod, please prefix them with the name of your mod to avoid using common file names. For example, instead of name my file Loading.jpg, which is rather generic and may be overwritten easily, I would name it le717sModLoadingScreen.jpg, assuming the name of my mod is "le717's Mod".