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.

I agree that there would be two things to do here:

1. As suggested in #4, add a link rel=canonical when "same name in other versions" is known, and link that to the current version.
2. As suggested in #6, when viewing outdated documentation add a banner like "You are viewing outdated documentation, for the index of the most current documentation, go to X".
3. A special case of #6 I think is when a "same name in other versions" is known, we can specifically list to that page for the current version instead of generally to the index of the other version.

I'm trying to find docs on how to set up a local API test site, but only found it for Drupal 7 so far.

D10 setup: https://git.drupalcode.org/project/api/-/tree/2.x/demo?ref_type=heads

This 📌 Add 'supported' flag to branches to use to direct users and bots Active should go first.