Style Guide

This style guide should contain the basics of how to structure content within a page, as well as aid in maintaining consistency within the wiki.

Guide

Article Leads

• Every article should start with the Paragraph text style, and not Heading/Subheading 1, 2, 3, etc.
• The first sentence defines the subject.
• The first paragraph summarizes the page (if you are unsure of how you want to structure the page, it would be wise to fill in the content first, and come up with the introduction later).
• Avoid excessive conversational language and opinions.

Acronyms

• Expand on first use in every article.
• Use the acronym thereafter.
• For example: Mouse-Only (MOON) for the first occurrence, and then MOON thereafter.
• Exception: Universally recognized terms (pp, osu!, etc).

Links

• Link the first occurrence of a term in the article.
• Don't repeatedly link the same term in every paragraph.

Dates

• In tables, infoboxes, and machine-readable data, use the ISO-8601 format: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS where a time is required.
• Omit components that are not known (e.g. don't invent 00:00:00 if the time is unknown).
• In prose, use the format "27 July 2027." Do not add the ordinal suffixes ("st," "nd," "rd," "th") to the day.

Numbers

• Use commas (,) to space out large numbers, and use the decimal point (.) to represent decimal values (e.g. 1,234,567.89).

Tone

• Be factual and concise, and primarily neutral. However, it is perfectly acceptable to write in a friendly manner, so long as the author is professional.
• Avoid colloquialisms and idioms, as non-native English speakers may find it difficult to understand.
• Attribute opinions only where necessary, rather than stating them as fact.

Terminology

• Refer to the glossary of preferred names for recurring concepts.