Minecraft Wiki
Advertisement
Merge-arrows
This page is in the process of being merged with Minecraft_Wiki:Projects/Template_documentation_cleanup. 
Relevant discussion may be found on this page's talk page for more information.
This project is believed to be inactive. 
If you are not currently a member of the project, you may still want to consider joining it. This status should be changed if any activity resumes.

This project seeks to maintain the Minecraft Wiki's templates.

Scope[]

  • Improving template documentation
  • Standardizing templates
  • Deleting unused templates
  • Categorizing templates

Template documentation[]

The current general layout to write a documentation
  1. Lead text explaining the template's purpose.
  2. (Sometimes) Parameters section
    1. (If required, sometimes) Specific parameter subsection.
  3. Usage section
  4. (If needed, optional) Example section
  5. See also section
That should be changed to this
  1. Lead text explaining the template's purpose.
  2. Usage section
    1. (If required) Parameters subsection
      1. (If required) Specific parameter subsubsection.
  3. (If needed, optional) Example section (Note: It should be on tables)
  4. See also section

How to clean up documentations[]

Message boxes[]

Message box templates are the most used ones, and they should be (for now) the main priority of the project.

The Usage section has to use <pre style="display: table;">{{Template|parameters}}</pre> to display all the parameters on the template, and below that goes the explanation of all the existent parameters, using {{p|parameter}} ({{cd}} should only be used when talking about technical things such as namespaces). If required, a parameter can have specifications below the general list of parameters.

Below that goes the optional Example section, which isn't required normally, but if the parameters become too confusing for ediors, a general explanation using examples is the best way to solve that. Finally goes the See also section, whish lists related or similar templates, using ; to start a subdivision to divide the types of templates there.

There are two examples of how the general style of these type of templates should be:

General example 

Parameters section example 

Infoboxes[]

Infoboxes are the second most important type of templates used on the wiki, so they are also part of the main priority (not the main focus for now).

The Usage section has to use <pre style="display: table;">{{Template|parameters}}</pre> to display all the parameters on the template. Then goes a table showing all the existent parameters, their descriptions, and a note if needed. If required, a parameter can have specifications below the general list of parameters, on a specific subsection.

Below that goes the optional Example section, which isn't required normally on these templates. Finally goes the See also section, whish lists related or similar templates, using ; to start a subdivision to divide the types of templates there.

To see an example of what we should do, see the documentation of the {{block}} template (note that it still needs to be improved, but for now it works fine):

Documentation example 

To do[]

  • Make sure template documentation pages show examples of the template with different combinations of parameters.
  • Redesign some templates so they can be substituted cleanly.
  • Categorize uncategorized templates.
  • Replace direct transclusions of {{msgbox}}.
  • Expand the template list at MCW:Templates.
  • Facilitate the creation of requested templates.
  • Move template-like subpages of articles to template space.
  • Make the wording of msgbox templates more concise.
  • Split some templates that have more than one function.
  • Merge very similar templates.

Participants[]

Use three tildes (~~~) to add your username. Please note any specific interests pertaining to templates.

Finalized templates[]

Moved from Minecraft_Wiki:Projects/Template_documentation_cleanup

Templates missing the "See also" section

Helpful links[]

Advertisement