Wiki:Style Guide
This page documents rules, styles, and conventions for Puzzles 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 someone who knows nothing about a given puzzle.
- 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. As many puzzle-related terms will have their own page, don’t be afraid to link to a relevant article.
- Keep paragraphs and sentences short and concise.
- Use contractions or don't. Just be consistent.
*Unless jargon is required to explain a particular puzzle or element.
Tense
Always write in the present tense.
This rule is particularly important when writing about puzzle solutions. Due to the persistent nature of puzzles and puzzle hunts, a puzzle can (usually) always be solved, and should be treated as if one is solving it along with your writing.
This should be the case regardless of how old a puzzle or hunt is. Certain exceptions may be made, in particular if a puzzle is of historical significance but can no longer be solved in any form, or if a puzzle only exists as a solution. In these cases, the past tense may be used, but if unsure, an editor may be contacted for confirmation.
Example:
Solvers had to score ten points in order to solve the puzzle.
Should be written as:
Solvers have to score ten points in order to solve the puzzle.
Side note: refer to hypothetical people solving a puzzle as “Solvers”. Do not make up placeholder names, as your descriptions of a solve path should be more like a news report than a story.
Example 2:
If that's done properly, the unused letters in each wall could be taken and placed in the columns in dropquote fashion, revealing a final phrase that clued the puzzle's final answer, which was ANSWER.
Should be written as:
If that's done properly, the unused letters in each wall can be taken and placed in the columns in dropquote fashion, revealing a final phrase that clues the puzzle's final answer, which is ANSWER.
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 puzzle. Puzzles 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 words "we" and “I” at all costs! Instead, consider replacing it with something like "solvers" or the hypothetical “one”, depending on the context.
Example:
I can solve the puzzle by extracting the second letters of each answer
Should be written as:
One can solve the puzzle by extracting the second letters of each answer
OR
Solvers may solve the puzzle by extracting the second letters of each answer
Mentioning Community Members and Teams
Community members and teams may be mentioned by name within a puzzle or hunt page if:
- They wrote a particular puzzle/produced a particular hunt
- They won a particular hunt (or were close enough to be notable)
- They produced a noteworthy addition to a puzzle or hunt’s trivia, such as a particular meme associated with that puzzle or hunt (i.e. BE NOISY)
Community members and teams should not be mentioned by name within a puzzle or hunt page if:
- They only solved a single puzzle first
- They only completed a hunt in any place other than first
- They were only part of a winning/writing team
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 or team 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, the following formats can be used:
MON. DD, YYYY
Month DD, YYYY
Month DD
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 EXCEPT in the case of hunts with an on-site component, in which case AM/PM may be used, and time should be written in the timezone of the hunt’s location (EX: MITMH should be written in Eastern Time).
Page Structure
To aid in the definement of proper page structure, there are several pages that help define the proper arrangement of the primary types of pages one will see on the wiki. They can be found at the following links:
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 Atlas Shrugged (MITMH 2000) and Atlas Shrugged (MITMH 2007), or Blocks (MITMH 2015) and Blocks (MITMH 2016). If two puzzles have the same title, include both the general name of the hunt and the year it took place, unless a hunt has only occurred a single time and can be identified from name alone (i.e. Puzzle Rojak).
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.
- puzzle hunt vs. puzzlehunt vs. Puzzle Hunt vs. Puzzlehunt
- Use two words whenever you aren’t using the phrase to refer to the title of a particular hunt. Otherwise, abide by the official title of the hunt as it appears on the hunt’s website or other documentation (e.g. “The Galactic Puzzle Hunt is a puzzle hunt run by ✈✈✈ Galactic Trendsetters ✈✈✈.”)
- Metapuzzle vs. Meta puzzle
- The former (one word) should be used to refer to the type of puzzle in which several answers from other puzzles come together to create another answer. The latter should not be used, unless referring to a puzzle that is in some other way “meta”, i.e. self-referential or self-aware (e.g.”The metapuzzle for this round, which referenced other metapuzzle within the hunt, ended up being a very meta puzzle.”). NEITHER terms should be used in place of the word “round”.
