Board Thread:Watercooler/@comment-5590118-20150701035141/@comment-3032314-20150930044046

Dessamator wrote: [W]hat do we do about Wikipedia developed modules?

Do we import them here, or simply link to them. I've added a new parameter to Module:Luadocs, , that allow us to specify specific pages as documentation pages, I think that looks cleaner than having the external docs links, we can make the link a different color or format it to be an external link instead.

Edit:

That's unless we make extensive changes to the module, then it might be better to simply import them here and change them as needed.

After thinking about this for a few days, I might have a solution.

Documentation pages let end-users understand a module without having to read its source code. They also provide a convenient place to list authors and, for ported modules like Module:Inspect, link back to the original source. For those reasons, every module should be documented. In order to make documentation less redundant, only the following information is needed for ported modules:


 * An infobox with the usual links.
 * A short description, ideally copied from the original source.
 * The Lua parallel for Template:Script Install, once we write that.

Because every module will have a documentation page, we can no-longer overwrite the default "docs" link on Module:Luadocs. Instead, I suggest we use the module's name as a link to the original source when necessary. For example, the links for Module:List would look like this:

http://i.imgur.com/QuDsepf.png

For this to work, we would have to remove the  and   args. Replacing them would be a new arg called, which would accept a URL and update the title accordingly. For more information, please see Module:Luadocs/sandbox.

Do you think that would work, or is there something I overlooked?