Remove Drupal 8.9.x and Drupal 9.5.x from api.drupal.org and redirect to 10.3.x or 11.x

No, we should list older versions and redirecting isn't very user-friendly if you need to read the old docs.

We need to fix the issue with bad search results in another way. We probably need to use "current" or something.

By the way, this is the docs list from our friends at Symfony:

Could we ask them what they have done? It doesn't seem to be robots-related - neither robots.txt or robots header explains this:

Google search: intitle:"The HttpKernel+Component" site:symfony.com

rel="canonical" should probably help with the search results, and could point to '11.x' until we rename it to 'main', then we'd have to update to point there instead. Not sure if that would be a feature request to api.drupal.org or a d.o-specific custom module.

No, we should list older versions

At the moment we list 8.9.x, which is unsupported for a very long time now, but not 10.2.x which is the current recommended release, or 10.1.x which still has security coverage (not for long).

I would not mind if older branches were listed in a drop-down similar to Symfony's, but at the moment they're top level menu items.

Yeah, I missed canonical. It seems to explain the decent search results for Symfony.

The bad search results are more serious when moving between versions is hard.

I like how QGIS solves this by adding a prominently red fixed bar at the top, linking to the latest version:

This documentation is for a QGIS version which has reached end of life. Instead visit the latest version.

Example from old version 3.16 https://docs.qgis.org/3.16/en/docs/user_manual/print_composer/composer_i...

"latest version" links to https://docs.qgis.org/3.34/en/docs/user_manual/print_composer/composer_i...

I do think we should keep some old versions. If you end up with an old site, or old memory, it is useful to see old documentation, to help track down what has changed.

I also want the old versions around. This is really a UI problem that needs to be solved.