- Issue created by @catch
- 🇳🇴Norway hansfn
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
- 🇬🇧United Kingdom catch
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.
- 🇳🇴Norway hansfn
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.
- 🇩🇰Denmark ressa Copenhagen
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...
- 🇺🇸United States drumm NY, US
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.