Difference between revisions of "User:Rayanth/SandboxMoS"

From EVE University Wiki
Jump to: navigation, search
m (Remove {{Work in progress}} as per the guideline that maintenance templates should not be used in the User namespace.)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{work in progress}}
 
 
==Outline==
 
==Outline==
  
Line 51: Line 50:
 
** Good examples: "A member", "a player", "they"
 
** Good examples: "A member", "a player", "they"
  
===Articles===
+
===Grammar===
 
* Capitalization should be minimized, except when used to match capitalization as applied in game, or proper nouns.
 
* Capitalization should be minimized, except when used to match capitalization as applied in game, or proper nouns.
** Title case is not necessary in page/section/subsection titles - however, if present, "fixing" them is very low priority.
+
** Title case is not necessary in page/section/subsection titles - however if present they can be left alone.
**
+
* Excessively long paragraphs should be avoided if possible
 +
** Short paragraphs allow the reader to "catch their breath" and "digest" what they've read easier
 +
** Also easier to find specific info when scanning the page, and remember where they left off when reading in stages.
 +
** Relevant images and diagrams count for breaking up the content
 +
 
 +
 
 +
===General Editing Considerations===
 +
* Organize into clear sections and subsections to make it easier to find specific content
 +
* Consider "Detail" pages when a topic gets heavy, and leave the main topic as an overview with links to the detail pages.
 +
** Example: Industry is a massive topic, including Research, Invention, Reprocessing, Manufacturing
 +
** Each are their own topic but "Industry" can be an overview with brief explanations of each, then link to their detail pages.
 +
* Important! ALWAYS check for pages that link to the article being edited before removing or renaming any sections.
 +
** Articles may cross-link to a specific subsection, which breaks if the name of that subsection is changed.

Latest revision as of 15:09, 7 April 2022

Outline

Style/Skin/Theme

  • CSS Styles should be avoided on individual articles whenever possible.
  • Applied Styles should always consider the following:
    • Print mode
      • Avoid coding background colors, they override Print-mode css and use up toner
      • Avoid coding light-colored text, as they won't be visible on white paper
      • Avoid hiding information between interactive elements, they aren't interact-able on paper
      • Avoid portraying information solely through animations - they will be static on paper
    • Mobile mode
      • Avoid excessively wide minimum-widths on elements, e.g. tables, when possible
      • Try to account for bandwidth whenever possible
      • As with print, provide alternative sources of info that is hidden behind interactive elements such as tooltips. It is difficult to 'hover' on mobile.
    • Accessibility
      • Consider color-blind; only use colored text when necessary, and always use the template for it {{co|}}
      • Don't shrink text to any smaller than it is by default.
      • Always use 'em's when setting font-sizes, elements, etc. These will scale with user's browser settings. Pixels do not.
    • Compatibility
      • Check http://caniuse.com to ensure target browsers will support the style
      • Minimum Browser support required, based on site visitors:
        • Chrome: Version 72+
        • Firefox: Version 56+
        • Safari: Version 10+
        • Edge: Version 16+
        • IE : Version 11+
        • Opera : Version 62+
      • When possible, include Mobile browsers of equivalent versions in the check.

Wiki Overall

  • The wiki should be accessible to all players of EVE Online, regardless of affiliation or handicap
  • The wiki should be welcoming to new editors and authors, so long as they "play by the rules"
  • The wiki should be easy to edit, with guidelines that encourage doing so
    • Guidelines should be simple and concise
    • Guidelines should be easy to remember, so the MoS doesn't have to be referred to frequently.
    • Guidelines should be relaxed enough that 'minor' edits are not required to fix things if they're just slightly off.
    • There should be no 'fear of reprisal' if rules are 'broken' - just an encouragement to follow them.

Perspective and Language

  • The style guide should account for and permit variations in dialect
  • Articles should be written with a clear purpose
  • The primary wiki shall be written in English - translation wikis, if created, will of course use their own language.
    • No preference for UK/US/Canadian/etc dialect
    • Minor edits to adjust dialect should be avoided.
    • Language and terminology used should account for non-native speakers.
  • Articles should be written in a third-person, passive perspective.
    • Avoid 'you', 'me', 'us', etc. - Articles have no single author, and address the wider audience as a whole.
    • Also avoid gender, unless clear or necessary (e.g. discussing a specific NPC whose gender is known)
    • Rework to "they" in a passive tense - don't make it seem personal
    • Good examples: "A member", "a player", "they"

Grammar

  • Capitalization should be minimized, except when used to match capitalization as applied in game, or proper nouns.
    • Title case is not necessary in page/section/subsection titles - however if present they can be left alone.
  • Excessively long paragraphs should be avoided if possible
    • Short paragraphs allow the reader to "catch their breath" and "digest" what they've read easier
    • Also easier to find specific info when scanning the page, and remember where they left off when reading in stages.
    • Relevant images and diagrams count for breaking up the content


General Editing Considerations

  • Organize into clear sections and subsections to make it easier to find specific content
  • Consider "Detail" pages when a topic gets heavy, and leave the main topic as an overview with links to the detail pages.
    • Example: Industry is a massive topic, including Research, Invention, Reprocessing, Manufacturing
    • Each are their own topic but "Industry" can be an overview with brief explanations of each, then link to their detail pages.
  • Important! ALWAYS check for pages that link to the article being edited before removing or renaming any sections.
    • Articles may cross-link to a specific subsection, which breaks if the name of that subsection is changed.