Forum:Template Documentation Policy
I've recently come across a problem with the Wiki templates. Some of them, such as any of the Infobox templates, have some really good documentation on how to use them. However, others, such as Template:Coins small, Template:Topright, Template:Topleft, Template:!!, Template:!(, Template:(, and Template:(( all have some very poor documentation, and I know there are definitely others that have little to no documentation. Now, I know what these do, as do most people who use them, however, if a new user comes across these, they won't know how to use them.
Two things are being proposed here.
- Add a section to RuneScape:Templates, or if not there, a policy page, stating that all new templates must have proper documentation.
- If there are any exceptions to what should have documentation, please say what should not have it, and why. An obvious example would be any of the signatures.
- Create a project to provide all current templates with documentation.
Support - Yes please. Not all editors know how to look into templates to see how one is meant to be used. Infobox ones have way too much stuff in it, and without the doc it would be a nightmare, but even things likecan be confusing.
06:26, November 3, 2012 (UTC)
Support - Templates without documentation is just too horrible07:56, November 3, 2012 (UTC)
Support - Aye, definitely.10:56, November 3, 2012 (UTC)
Support - Documentation is always nice. Hair 15:25, November 4, 2012 (UTC)
- But I confuse you all the time! D: 22:10, November 8, 2012 (UTC)
- confüs* MolMan 22:12, November 8, 2012 (UTC)
Closed - This thread creates the template policy for the RuneScape Wiki and adds a requirement to document templates. There is now also enough substance to create a project to document existing templates. The criteria that determine which templates need to be documented need to be fleshed out a bit further, such as for the obscure templates !( and ((, and I've added a section about template preloads which needs more information.
10:04, November 12, 2012 (UTC)