It would be good to have a disclaimer on the old pages to link to the recent versions.
Unfortunately, search engines still guide people (like me) to the old sites, which are not always helpful.
The https://wiki.gnome.org/ already has such a disclaimer. I would expect something similar.
The handbook: https://handbook.gnome.org/index.html does not include the information I am searching for and https://developer.gnome.org is also much more about processes than about docs of Gnome or GDM
How can this be improved?
For reference, I am looking for the up to date docs of this page: https://help.gnome.org/admin/gdm/stable/troubleshooting.html.en
In practice, though, it’s a bit more complicated than this:
the docs team is, for all intents and purposes, disbanded
the application documentation is not up to date, when it’s even available
the tooling for generating the application documentation is barely functional
the tooling for generating the website from the application documentation is unmaintained and has bitrotted
the format used to write the application documentation is a bespoke, artisanal, organic, locally sourced format that nobody else uses, and can be hard to get into—especially since the documentation of the documentation format has now gone offline
Compared to the issues above, “help.gnome.org is out of date” is a drop in the ocean.
It doesn’t look too bad and I would really much like to help somehow, if there are some hints where to get started or if the best option is to just throw everything away (which I doubt as there already is really much).