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

Dessamator wrote: I would add that the syntax for the module should also be included, and perhaps some examples.

Um... isn't the point to reduce redundancy, by linking to the preexisting docs?

Dessamator wrote: I'm actually conflicted between using the module name as a link to the actual docs vs using the docs. Generally speaking most people would probably have the impulse of clicking the main link, instead of the docs, and it is likely they'd expect it to lead them to local documentation.

I can see how that might confuse people. Hopefully the "external link" icon (plus Wikipedia or GitHub, where applicable) is enough of an affordance...

Dessamator wrote: We can automatically detect external Wikimedia/wikipedia links based on their url, and add the icon accordingly.

Dessamator wrote: We could also add icons relating to github whenever we detect their url. That will benefit us if someone improves it, just as we benefit from the improvements that their authors made.

Wikipedia and GitHub are already added to Module:Luadocs/sandbox. Feel free to suggest others! :)

Dessamator wrote: Also, unlike wikimedia projects (because of history), externally hosted documentation may become dead links. So we should always strive to document as much as possible when it isn't a wikimedia hosted project.

Maybe we could use the Wayback Machine?