Board Thread:Watercooler/@comment-24473195-20150915112607

Currently there's a big list of useful modules in the List of Lua Modules, but end-user documentation is lacking. Wikipedia uses the /doc subpage for module documentation, but perhaps it would be better to use another namespace given its issues:


 * 1) No support for it in Wikia's MediaWiki version


 * 1) Namespace becoming confusing with docs and modules


 * 1) https://phabricator.wikimedia.org/T95071


 * 1) https://phabricator.wikimedia.org/T61194


 * 1) Pages from the module namespace showing up in Special:WantedPages, wantedcategories, wantedtemplates,etc


 * 1) Anything in the Module namespace is a global module, so it doesn't make sense to store documentation there anymore

It could also become a complicated mess when trying to document subpages, e.g. Module:Parser/Data/doc,  Module:Parser/doc, Module:Parser/Doc/Data(??). Generally speaking the main namespace is being ab(used) as storage for js/css/docs.

A wiki was certainly not designed to store pages of code, and even in a proper development environment, code and documentation are put in separate folders (namespaces). 