readme points to non-existing user-guide

[andrewufrank]

Describe the bug
on the cabal 3.4 page found with hackage, the readme points to a non-existing (404) user guide

To Reproduce
open page http://hackage.haskell.org/package/Cabal-3.4.0.0#readme and scroll down to more information, click on user guide and you get a 404 error (on may 12, 2021)

I guess to point to the actual version of the user guide is important. Google gives various answers, not all are the current 3.4.0.0 user's guide. Thank you for including the version in the title, it is shown in the google result page (together with a number of unversioned, older ones).

[Mikolaj]

Confirmed. Thank you. And the 'API documentation' link is broken, too.

@emilypi: do you know if in the past the https://www.haskell.org/cabal/users-guide link somehow pointed to the newest guide (currently at https://cabal.readthedocs.io/en/latest, I think)? If so, I guess we could try to restore it and be done.

BTW, the link at https://www.haskell.org/cabal/ points to https://cabal.readthedocs.io/en/3.4/ instead. I guess any files included in a release should ideally point to the guide matching the release version while any fixed web page should point to the lastest guide.

[Mikolaj]

@emilypi: I won't make it to today's meeting (holiday here in Poland). This ticket is the only agenda item I would have, so a kind ping. :)

Edit: and AppVeyor CI (see IRC). I guess we should just turn it off, but I think I can't, despite admin on github.

[Mikolaj]

@emilypi: the problem persists for https://hackage.haskell.org/package/Cabal-3.6.1.0

[gbaz]

Redirect added, but we should update the link properly.

[Mikolaj]

@gbaz: is anything left to do still?

BTW, yesterday the "API documentation" link at https://github.com/haskell/cabal/blob/master/Cabal/README.md stopped working properly. Should we point it to Hackage instead?

[gbaz]

I'll close, but also yes pointing the api documentation link to hackage sounds like a good idea.

[Mikolaj]

@andrewufrank or @gbaz would you have a quick look at #7841 and nod you approval?