Board Thread:Wiki discussions and announcements/@comment-658634-20170109151805/@comment-1990160-20170110185357


 * Teh's Thoughts

Embedding data and details behind multiple layers of templates functionally advantageous, but the mechanics/hierarchy/everything should be thoroughly and clearly documented.


 * What I think we should have
 * A master guide for template ordering, structured like User:TehAnonymous/Sandbox/4 (describes champion & item pages, outdated) and User:TehAnonymous/Sandbox/10 (homepage, recently updated)
 * Each template should be briefly explained in the master guide and thoroughly explained in their /doc.


 * Example of poor transparency and documentation

Editing the section Armor, I see in source mode:

From this, I don't understand what's going on or how a large table was generated from three short lines. Return to the page, check that yes it works, a newbie would throw their hands up and stop there. A much more experienced wiki editor would recognize them as templates, and maybe check the templates to understand what's happening.

Documentation level is as follows
 * Stat table header: Nonexistent
 * Do for every item: Minimal, not intelligible to the layman. Possibly try for more ELI5 / "rubber duck" style of explanation.
 * Item table row: Nonexistent
 * Stat table footer: Nonexistent