This came up while discussing an edit to one of the Haskell documentation pages. A user proposed an edit to change a link to Data.Text
from Hackage, where the official, core documentation is about the pacakage, to an internalinternal link to SO Documentation for Data.Text
.
It seems to me that external links can provide more value (since we aren't going to replicate all of the information about functions and type signatures or the source code internally) by pointing someone back to the original documentation for the package while still providing additional explanations and examples.
On the other hand, SO.Documentation is, at least in part, built around the idea of "No more broken links" as discussed in the tourtour. Should we have external links in the documentation? If not, should we replicate all of the relevant information inside the documentation?