<p>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.
</p><p>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
/doc
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.
</p><p>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:
</p>
- Edit the Wiki Style Guide to include more information about wiki programming.
- An alternative to #1 could be to create more subpages of
Help
and put documentation there (similar to Help/Wiki Code, see below).
- Create a category with general documentation information, also containing the category for template documentation.
- In addition to #3, create a
Doc:
namespace which would be used to separate documentation from the wiki with actual content.
<p>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.
</p><p>As per those options, I would see #1 as being mutually exclusive of #3 and #4, and #2 being mutually exclusive of #4.
</p>
<div class="ajax-poll" id="ajax-poll-7737EFC0B3B8F01B054BDB7A1994D4C2"><div class="header">Which do you think is the best approach? </div><div id="wpPollStatus7737EFC0B3B8F01B054BDB7A1994D4C2" class="center"> </div><form action="#" method="post" id="axPoll7737EFC0B3B8F01B054BDB7A1994D4C2"><input type="hidden" name="wpPollId" value="7737EFC0B3B8F01B054BDB7A1994D4C2"><div id="ajax-poll-area"><div class="pollAnswer" id="pollAnswer2"><div class="pollAnswerName">#1 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote7737EFC0B3B8F01B054BDB7A1994D4C2-2" title="62.5% of all votes">20</span><div class="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2" id="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2-2" style="width: 62.5%; border:0;"> </div></div></div><div class="pollAnswer" id="pollAnswer3"><div class="pollAnswerName">#2 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote7737EFC0B3B8F01B054BDB7A1994D4C2-3" title="18.75% of all votes">6</span><div class="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2" id="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2-3" style="width: 18.75%; border:0;"> </div></div></div><div class="pollAnswer" id="pollAnswer4"><div class="pollAnswerName">#3 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote7737EFC0B3B8F01B054BDB7A1994D4C2-4" title="9.38% of all votes">3</span><div class="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2" id="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2-4" style="width: 9.38%; border:0;"> </div></div></div><div class="pollAnswer" id="pollAnswer5"><div class="pollAnswerName">#4 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote7737EFC0B3B8F01B054BDB7A1994D4C2-5" title="9.38% of all votes">3</span><div class="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2" id="wpPollBar7737EFC0B3B8F01B054BDB7A1994D4C2-5" style="width: 9.38%; border:0;"> </div></div></div>
<div>The poll was created at 23:08 on April 12, 2018, and so far <span class="total" id="wpPollTotal7737EFC0B3B8F01B054BDB7A1994D4C2">32</span> people voted. </div></div>Poll is closed now. Enjoy the results. </form></div>
<div class="ajax-poll" id="ajax-poll-694BE9D78579B731E002C5D352BE1287"><div class="header">Second best? </div><div id="wpPollStatus694BE9D78579B731E002C5D352BE1287" class="center"> </div><form action="#" method="post" id="axPoll694BE9D78579B731E002C5D352BE1287"><input type="hidden" name="wpPollId" value="694BE9D78579B731E002C5D352BE1287"><div id="ajax-poll-area"><div class="pollAnswer" id="pollAnswer2"><div class="pollAnswerName">#1 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote694BE9D78579B731E002C5D352BE1287-2" title="22.86% of all votes">8</span><div class="wpPollBar694BE9D78579B731E002C5D352BE1287" id="wpPollBar694BE9D78579B731E002C5D352BE1287-2" style="width: 22.86%; border:0;"> </div></div></div><div class="pollAnswer" id="pollAnswer3"><div class="pollAnswerName">#2 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote694BE9D78579B731E002C5D352BE1287-3" title="54.29% of all votes">19</span><div class="wpPollBar694BE9D78579B731E002C5D352BE1287" id="wpPollBar694BE9D78579B731E002C5D352BE1287-3" style="width: 54.29%; border:0;"> </div></div></div><div class="pollAnswer" id="pollAnswer4"><div class="pollAnswerName">#3 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote694BE9D78579B731E002C5D352BE1287-4" title="17.14% of all votes">6</span><div class="wpPollBar694BE9D78579B731E002C5D352BE1287" id="wpPollBar694BE9D78579B731E002C5D352BE1287-4" style="width: 17.14%; border:0;"> </div></div></div><div class="pollAnswer" id="pollAnswer5"><div class="pollAnswerName">#4 </div><div class="pollAnswerVotes" onmouseover='span=this.getElementsByTagName("span")[0];tmpPollVar=span.innerHTML;span.innerHTML=span.title;span.title="";' onmouseout='span=this.getElementsByTagName("span")[0];span.title=span.innerHTML;span.innerHTML=tmpPollVar;'><span id="wpPollVote694BE9D78579B731E002C5D352BE1287-5" title="5.71% of all votes">2</span><div class="wpPollBar694BE9D78579B731E002C5D352BE1287" id="wpPollBar694BE9D78579B731E002C5D352BE1287-5" style="width: 5.71%; border:0;"> </div></div></div>
<div>The poll was created at 23:07 on April 12, 2018, and so far <span class="total" id="wpPollTotal694BE9D78579B731E002C5D352BE1287">35</span> people voted. </div></div>Poll is closed now. Enjoy the results. </form></div>
<div style="-moz-border-radius: 10px; -webkit-border-radius: 10px; width: 180px; background-color:#D07130; border:5px ridge #cccccc"><div class="center"><div class="floatnone">

</div></div></div>