haskell / cabal-website

The http://www.haskell.org/cabal/ website
4 stars 15 forks source link

Outdated cabal documentation #14

Open tomjaguarpaw opened 3 years ago

tomjaguarpaw commented 3 years ago

The original Cabal proposal (which must be from about 20 years ago) appears on Haskell.org. It is not clearly marked as an archive of a historical document. A user tried to follow it to enable FlexibleContexts, specifically the The Cabal simple build infrastructure section.

Is it possible to perhaps just delete it and let the internet archive preserve it for posterity? Alternatively, if as a historical document it should be preserved, could it be clearly marked as a historical document, not for up-to-date use, and perhaps even moved to another domain (haskell-history.org?).

It's really, really confusing for users to come across documentation that is not up-to-date. See an example that occurred just today.