URLs no longer include minor version

Created on 29 January 2023, over 2 years ago
Updated 30 January 2023, over 2 years ago

Problem/Motivation

URLs used to end in the MAJOR.MINOR version number, but recently the URLs for D9 and D10 docs only end in MAJOR, e.g.

https://api.drupal.org/api/drupal/core%21modules%21node%21src%21Entity%2...

Is this a temporary glitch or a new change?

If the latter, it's confusing that the breadcrumb still says MAJOR.MINOR (see that page).

Also, is there no longer a way to consult the docs for a past minor?

E.g. if the current release is 10.3, but my project is on 10.1 still, I will see docs which potentially mention features I don't have in my codebase.

Steps to reproduce

Proposed resolution

Remaining tasks

User interface changes

API changes

Data model changes

πŸ› Bug report
Status

Closed: works as designed

Version

2.0

Component

User interface

Created by

πŸ‡¬πŸ‡§United Kingdom joachim

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

  • Issue created by @joachim
  • πŸ‡ͺπŸ‡ΈSpain fjgarlin

    In this case, I think it's down to how the branch was created. We can change "10" for "10.0.x". I think this is just content change (and then perhaps reindexing/reparsing) that @drumm can do.

  • Status changed to Closed: works as designed over 2 years ago
  • πŸ‡ΊπŸ‡ΈUnited States drumm NY, US

    This is a new change. The parsing and navigation for every minor version at the current cadence of core releases was getting unmanageable. We do want to be specific about what documentation you are viewing; updating to parse 10.4 instead of 10.3 is a manual process, and will remain at the same URLs.

    The most minor versions we could keep would be something like keeping the last ~3, or keeping them all until the next major version is released. However, then the minor-version-specific URLs would regularly be removed and more cumbersome to maintain. Having the URLs be the same for the whole major release cycle keeps more URLs at the same place.

    I think that’s not worth it right now since:

    • APIs should be backward-compatible in each minor version.
    • Minor version updates for sites should be within reach to upgrade when you find a need to, including for using new APIs.
    • The in-code documentation can mention when changes and additions were made.
Production build 0.71.5 2024