Difference between revisions of "Meta:Style Guide"

From Game Detectives Wiki
Jump to: navigation, search
[checked revision][checked revision]
(Work In Progress)
(General Guidelines)
Line 11: Line 11:
 
=== General Guidelines ===
 
=== General Guidelines ===
  
 +
* Pages should be written in English.  If a page requires use of another language, an English translation should be provided.
 
* '''Proofread your edits!'''  If you see a typo on a page, don't hesitate to correct it!
 
* '''Proofread your edits!'''  If you see a typo on a page, don't hesitate to correct it!
* Write with the newbie's perspective in mind - try to make each page accessible to newcomers.
+
* Write with the newbie's perspective in mind - aim to craft pages that are accessible to newcomers.
 
* Take advantage of Mediawiki's formatting when appropriate.  Images and videos can be embedded in the page to maximize readability.
 
* Take advantage of Mediawiki's formatting when appropriate.  Images and videos can be embedded in the page to maximize readability.
 
* When embedding images, it's preferable to [http://wiki.gamedetectives.net/index.php?title=Special:Upload upload] them to our wiki, then embed (instead of embedding from an external source).
 
* When embedding images, it's preferable to [http://wiki.gamedetectives.net/index.php?title=Special:Upload upload] them to our wiki, then embed (instead of embedding from an external source).

Revision as of 12:14, 27 May 2018

This page documents rules, styles, and conventions for the Game Detectives wiki. Please try your best to adhere to them when creating new pages, writing new content, or editing existing content.

Wikipedia Manual of Style

This wiki adheres to the Wikipedia Manual of Style. This is the definitive style guide for wiki content and should be followed unless otherwise noted.

Overview

General Guidelines

  • Pages should be written in English. If a page requires use of another language, an English translation should be provided.
  • Proofread your edits! If you see a typo on a page, don't hesitate to correct it!
  • Write with the newbie's perspective in mind - aim to craft pages that are accessible to newcomers.
  • Take advantage of Mediawiki's formatting when appropriate. Images and videos can be embedded in the page to maximize readability.
  • When embedding images, it's preferable to upload them to our wiki, then embed (instead of embedding from an external source).
  • A full formatting guide can be found here.

Language

Tips:

  • Avoid ambiguity, jargon, and vague or unnecessarily complex wording.
  • Use words your audience will understand, and use just enough words to convey your message.
  • Define terms that may not be obvious to individuals who are new to what you are writing about.
  • Keep paragraphs and sentences short and concise.
  • Use contractions or don't. Just be consistent.

Tense

Always write in the past tense.

This rule is particularly important when writing about puzzle solutions. This rule applies even when writing about something that is presently occurring. If events are initially described in present tense, then the description needs to be altered later on to reflect that it happened in the past.

This also goes for future tense - talk about what information was revealed rather than where the investigation is today.

Example:

The website will be updated on the 12th of this month, according to the tweet by the PM.

Should be written as:

The PM tweeted that the website would be updated on the 12th of December.

Side note: As above, don't refer to dates relatively. Reference exact dates in the past tense to preserve readability even after the event concludes.

Example 2:

Discord user imnotgoats found the solution to puzzle one is: 27

Should be written as:

Players discovered puzzle one's solution was: 27

Side note: Reference participants as "player(s)" (as opposed to users, etc) to maintain congruence with other wiki articles.

Readability

As mentioned above, write with the newbie's perspective in mind. This means embedding the most pertinent media directly onto the page, and linking to relevant sources where necessary. When in doubt, more links and embedded media are better (but not to the point where you can't read any of the words on the page, of course).

Additionally, be wary of writing run-on sentences when describing what occurred in an ARG. ARGs can get really complex, really quickly, so it's easy for a newcomer to feel overwhelmed. When in doubt, step back and think about how to break down your explanation.

Point of View

The wiki should have a consistent, neutral voice, and should not read as though it was written by one or two solvers. Avoid using the word "we" at all costs! Instead, consider replacing it with something like "players" or "participants", depending on the context.

Example:

Through the use of clever lateral thinking, we solved the puzzle.

Should be written as:

Through the use of clever lateral thinking, players were able to solve the puzzle.

Mentioning Players

Players may be mentioned by name if:

  • They were the only person present at a live event
  • They were a prevalent player during a live event (eg. streamed the event)

Players should not be mentioned by name if:

  • They solved a single ARG puzzle
  • They solved multiple ARG puzzles
  • They were one of many players who attended a live event

Generally speaking, mentioning players by name in the body of the wiki has a negative impact on readability and detracts from an otherwise informational format. Separate credits pages, especially as demanded by the community, are encouraged, and the above rules need not apply to them.

Dates and Times

All dates written using solely numbers on the wiki should abide by the ISO 8601 standard:

YYYY-MM-DD

When writing dates inline, any of the following formats can be used:

MON. DD, YYYY
Month DD, YYYY
Month DD
DD MON. YYYY

Note: Please try to keep inline date styles consistent for any given page.

Times should be in written in 24-hour time, and should use the UTC timezone.

Page Structure

The main page for an ARG should use the ARGBox template, set to float to the right. At the top of the page, above the table of contents, there should be a brief summary of the ARG, including links to any related media.

Page Sections

Defining sections for a wiki page is often a judgement call for wiki editors. However, if an ARG is explicitly broken up into distinct segments, it may make sense to define the sections accordingly. For instance, Waking Titan is explicitly broken up into 3 "phases". Wiki editors mirrored this structure by breaking the ARG up into 3 sub-pages: one for Phase 1, one for Phase 2, and one for Phase 3. The first of these phases is broken up into 5 "sequences", so its wiki page is structured accordingly.

Subpages

The main page for an ARG can host whatever information is deemed necessary by wiki editors. If the ARG is small, the main page may suffice to contain the full documentation of the ARG. However, as ARGs become more sprawling and complex, more pages may be required to track them. Articles about high-level subjects can be created, named sensibly, in the main namespace. For all articles pertaining solely to a specific ARG, subpages should be used.

Example:

This_ARG                         <- this is a page as well as the namespace
This_ARG/Timeline
This_ARG/Summary
This_ARG/Characters

Additionally, when creating subpages, ensure you categorize them properly!

Disambiguation

Where there is a requirement for two articles with the same name in the same namespace, disambiguation should be used in the form of parenthesis after the article name. An example of this is Project 11 (the ARG) and Project 11 (puppetmaster) (the name of the puppetmaster).

Non-ARG articles

Articles that do not pertain solely to a specific ARG should be in the main namespace. This is because puppetmasters could potentially create more than a single ARG.

Nomenclature

This section outlines some naming conventions to promote consistency across the wiki. This section is not intended to comment on a phrase's 'correctness' in the real world - rather, these guidelines outline an approved style for this wiki.

  • "ARG" always appears in caps ("Arg" and "arg" are incorrect).
  • "Puppetmaster" is a single word ("puppet master" and "puppet-master" are incorrect).
  • "Easter egg" only has a capital on 'Easter' ("Easter Egg" and "easter egg" are incorrect).

Wiki Templates

Article Message Box

Description

This is the {{Ambox}} or Article message box meta-template.

Usage
{{Ambox|type=content|text=my text here}}, or
{{Ambox|type=speedy|text=my text here}}, etc
type

The type parameter defines the color of the left bar, and the image that is used by default. The type is chosen not on aesthetics but is based on the type of issue that the template describes. The seven available types and their default images are shown below.

If no type parameter is given the template defaults to |type=notice.

See also

ARGBox

Description

This is the {{argbox}} or ARG Info Box meta-template. This template is used to create an arg infobox on a given page, as well as assign the page to a category determined by the root page name.

Syntax

Type {{argbox}} somewhere, with parameters as shown below.

Sample output
{{argbox
| float       = left
| name        = Valve ARG
| image       = File:NewExample3.png
| imagewidth  = 400
| description = This it the description of an arg, I somehow forgot about it
| creator     = [[Valve]]
| creator2    = [[Valve]]
| type        = Official
| status      = Active
| discovered  = 1970-01-01
| completed   = 1971-01-01
| closed      = 1971-01-01
| reopened    = 1972-01-01 
| timeline    = [[Valve]]
}}

Results in...

Valve ARG
Active since 1970-01-01
NewExample3.png
This it the description of an arg, I somehow forgot about it
Type Official
Creators Valve & Valve
Discovered 1970-01-01
Completed 1971-01-01
Closed 1971-01-01
Reopened 1972-01-01
Timeline Valve
Parameters
Parameter Description Default Accepted Values Type Status
float box is aligned to the the left or the right. right left or right String Optional
clear content is delayed until just the right or left column is complete. right left or right String Optional
name The name of the ARG infobox Title of the current page String Optional
image The thumb of the ARG infobox Image:Example.png any valid link from local source or external String Optional
imagewidth Width of the thumb image of the ARG info box. Also controls the width of the argbox itself. 400 any valid integer Int Optional
description Short description of the ARG String Optional
creator A creator of the ARG String Optional
creator2 A second creator of the ARG String Optional
creator3 A third creator of the ARG String Optional
type The type of the ARG Official, Unofficial, Investigation String Optional
status Status of the ARG Active, On Hold, Completed or Discontinued String Optional
discovered Date of the ARG discovery, YYYY-MM-DD Date Optional
completed Date of the ARG completion, YYYY-MM-DD Date Optional
closed Date of the ARG closing, YYYY-MM-DD Date Optional
reopened Date of the ARG reopening, YYYY-MM-DD Date Optional
timeline Wikilink to the timeline article of the ARG String Optional
halloffame Whether to render a link to a Hall of Fame true or emtpy Boolean Optional
popupContent Manual override for given arg's investigation list dialog popup Any string including parsable wikitext (no HTML) String Optional

ArgHeader

Description

This is the {{ArgHeader}} or ARG Header meta-template.

It is an intelligent template used to add a navigation bar at the head of any ARG page. It is self-structuring and does not require any variable input.

Usage
{{ArgHeader}}

Main Page > List of Investigations > Meta:Style Guide

ArgHeaderSub

Description

This is the {{ArgHeaderSub}} or ARG Header Subpage meta-template.

It is a simple template to add a navigation bar at the header of a main, child ARG sub-page.

Usage
{{ArgHeaderSub}}

Main Page > List of Investigations > Meta:Style Guide


See Also

{{ArgHeader}}

Outdated

Description

This is the {{Outdated}} or Out-of-date content meta-template.

Usage

For out-of-date English content, writing {{Outdated}} creates...

For English pages that contain out-of-date information, simply add the template to the top of the page (or section if it only applies to part of the page). The template will be displayed as shown at the top of this page. You can also specify a reason:

{{Outdated|reason=MediaWiki doesn't run under XYZ Server anymore.}}

Which creates:

Out-of-date translations

For non-English pages that are out-of-date translations, include the name of the English-language page it was translated from. The resulting banner will include a link to the source text, like this:

{{Outdated|Page name}}
e.g. {{Outdated|Project:Language policy}}

Creates:

See also

{{Update}}

Stub

Description

This is the {{Stub}} or Stubby McStubbin meta-template.

Use {{stub}} or {{Stub}} at the top of any page in need of additional outside information or revision (for incomplete pages not in need of outside information or revision, use {{WIP}} instead.

Sample output
{{stub}}


See also

{{WIP}}

Work In Progress

Description

This is the {{WIP}} or Work in progress meta-template.

Use {{WIP}} at the bottom of any page or sub-page which is incomplete or being updated on an on-going basis.

Sample output
{{WIP}}