Minecraft Wiki

The Minecraft Wiki is no longer considered as official by Microsoft and therefore several changes are required to be made, including to the wiki's logo. Please read this announcement for more information.

READ MORE

Minecraft Wiki
Advertisement
Minecraft Wiki
This page is part of the Template documentation cleanup project. 
There is information about the project below this notice.
This is a project, an area for focused collaboration. 
New participants are welcome; please feel free to join!

This project plans to rewrite the documentation of templates to make them easy to understand for the common user. They can be organized on so many different ways that there should be a common style of how they should be written.

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

Priorities[]

  1. Message box
  2. Infobox
  3. Hatnotes
  4. Templates like {{only}}
  5. Multi-type like {{conjecture}}
  6. (Add and specify more templates, modifying this list)

Members[]

To join the project, add your signature to the bottom of this list using ~~~.

Finalized templates[]

This list may be moved to its own page if becomes too large. 
Add here the finalized templates.
Templates missing the "See also" section
Advertisement