Make a v2.8.0 release of the UserGuide

[IAlibay]

With MDAnalysis v2.8.0 now out, a new release of the UserGuide should be made.

[orbeckst]

A 2.8.0 version is out (PR #398 ?)

[IAlibay]

@orbeckst re-opening, the userguide v2.8.0 was not released - see the lack of tags for the release.

[RMeli]

#398 was the first few steps towards a release. Should I make a release without the guessers? If yes, I can take care of this tomorrow or over the weekend (I already botched a release today, so not tempting fate tonight...)

[IAlibay]

We have several folks asking for docs on the new Guessers, it would be nice for the 2.8.0 version of the userguide to have those details. However it's really up to y'all.

[orbeckst]

Then I am thoroughly confused by what you mean by "Release of the UG", given that https://userguide.mdanalysis.org/2.8.0/ is clearly available.

(EDIT: I see that the UG has its own release https://userguide.mdanalysis.org/2.8.0/preparing_releases_and_hotfixes.html#create-a-release-of-the-userguide — I just still don't see its relevance from a user perspective.)

[IAlibay]

@orbeckst it looks like the release process got broken and/or someone changed something - the way it's meant to be is that until you push tags you have a 2.8.0-dev0 branch on dev and a 2.7.0 on stable. So the user facing "latest" would just show 2.7.0.

It looks like the somehow that's no longer happening, not sure what happened there 🤷🏽‍♂️

[orbeckst]

ok, thanks for the explanation

[IAlibay]

Ah ok I know what went wrong here @orbeckst - the issue was that a 2.8.0 version of the docs got released during the time that we were on a feature freeze.

If you look at the docs for the 2.8.0 page (for example the changelog page that @RMeli recently updated) they are not up to date! https://userguide.mdanalysis.org/2.8.0/releases.html

There should be a 2.8.0 changelog entry in there but it only goes to 2.7.0.

[IAlibay]

What we'll want to do here is:

• clean up the 2.8.0 entry from the gh-pages branch
• when we're ready for a new release, push a new tag and let that build a new version of the docs

Alternatively you can skip directly to pushing new tags if you don't want to update the guessers docs first.

[lilyminium]

I've opened #409 and yanked the 2.8.0 entry from gh-pages, although the stable/ entry still points to the incorrect older 2.8.0 version; that's easiest to update via the deployment CI.