Current place of Help not found

Hello,
I want to create an issue about https://help.gnome.org not being up to date.
The library behind this: Infrastructure / library-web · GitLab is not updated for a few years as well

The link to https://library.gnome.org also links to the old help page.

Where can I find up to date help pages?

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

You can’t: help.gnome.org is a static snapshot.

The static snapshot is immutable, so we can’t “have a disclaimer” or a link.

By finishing the port to the “new” help.gnome.org: Make the new help website official (#12) · Issues · Teams / Websites / help.gnome.org WIP · GitLab

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.

What does this mean?
So there are not a lot of people taking care of it?

I just tried building the docs and of course failed (though I am python-experienced).

I tried using python < 3.12 and the itstool from GitHub - nwellnhof/itstool at lxml-migration to get around the lxml2 problems, but this still gives errors.

I found this page in the CI though, for anyone wondering how the documentation overhaul could look like! :slight_smile:

https://teams.pages.gitlab.gnome.org/Websites/help.gnome.org/

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).

@ebassi is there some way to join the matrix room at https://matrix.to/#/#pages:gnome.org which is advertised on the upper right at Teams / Websites / help.gnome.org WIP · GitLab ? Seems like it is not public?