Board Thread:News and Announcements/@comment-25330335-20180412231036

Over the past 1-2 years, we've had a huge increase in the number of templates that we use in our pages in order to present content. For example, the Template:Grid pages, which are used to display crafting grids. Also the Template:Bar category of pages, which are used to show numbers of hearts, meats, or coins.

These templates significantly improve the quality of our wiki pages. They make them look more professional, and tend to make it easier to keep these pages accurate. However, they add a certain amount of complexity to pages that may be intimidating or difficult to understand for many users. Many of these templates have a  sub-page that explains how to use the template. For the most part, this documentation was written with the templates themselves, and is very good.

However, it is not clear to many users how to read this documentation or how to understand how to edit. In a lot of cases, it's not clear to many that these docs even exist. We've been talking about how to address this issue in discord, and we've come up with a few ideas:


 * 1) Edit the Wiki Style Guide to include more information about wiki programming.
 * 2) An alternative to #1 could be to create more subpages of  and put documentation there (similar to Help/Wiki Code, see below).
 * 3) Create a category with general documentation information, also containing the category for template documentation.
 * 4) In addition to #3, create a  namespace which would be used to separate documentation from the wiki with actual content.

Currently the documentation is basically the Help/Wiki Code, which explains the basic mediawiki markup, but not some of the more complicated parts of the platform.

As per those options, I would see #1 as being mutually exclusive of #3 and #4, and #2 being mutually exclusive of #4.

Which do you think is the best approach? Second best?
 * 1
 * 2
 * 3
 * 4
 * 1
 * 2
 * 3
 * 4

 