Skip to main content
Post Closed as "Not suitable for this site" by pnuts, Stephen RauchMod, peterh, HaveNoDisplayName, Michael Gaskill
replaced http://stackoverflow.com/ with https://stackoverflow.com/
Source Link

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?

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 internal 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 tour. Should we have external links in the documentation? If not, should we replicate all of the relevant information inside the documentation?

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 internal 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 tour. Should we have external links in the documentation? If not, should we replicate all of the relevant information inside the documentation?

Source Link
jkeuhlen
  • 4.5k
  • 10
  • 4

Should Documentation links point to external or internal resources?

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 internal 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 tour. Should we have external links in the documentation? If not, should we replicate all of the relevant information inside the documentation?