Release nodes for major version initial releases contain inaccurate upgrading instructions

Created on 21 December 2022, about 2 years ago
Updated 13 September 2024, 3 months ago

Problem/Motivation

I have followed the instructions for updating my various modules with composer etc and /admin/reports/upgrade-status now tells me I am 100% ready to update to D10.

https://www.drupal.org/project/drupal/releases/10.0.0 says

To update your site and all dependencies to the latest version of Drupal:
$ composer update "drupal/core-*" --with-all-dependencies

But after running this command it seems I am still on 9.5.0 (screenshot below)

Any ideas please what I am missing?

Thanks

Proposed resolution

Ensure that major release candidates (e.g. 9.0.0, 10.0.0) expand Upgrade release notes to note the extra steps to upgrade from a major version beyond the default composer command Drupal.org provides by default (as seen in #3328588-12: Release nodes for major version initial releases contain inaccurate upgrading instructions ):

Mirroring what was done for the 9.0.0 release notes, @longwave added in the following to https://www.drupal.org/project/drupal/releases/10.0.0 :

Refer to Preparing your site to upgrade to a newer major version for tools you can use to check the Drupal 10 compatibility of modules, themes and sites. Then, upgrade from Drupal 9 to 10 .

Update the Drupal 11 draft release notes. see #20.

🐛 Bug report
Status

Fixed

Version

3.0

Component

Code

Created by

🇬🇧United Kingdom juc1

Live updates comments and jobs are added and updated live.
  • Documentation

    Primarily changes documentation, not code. For Drupal core issues, select the Documentation component instead of using this tag. In general, component selection is preferred over tag selection.

  • Needs issue summary update

    Issue summaries save everyone time if they are kept up-to-date. See Update issue summary task instructions.

Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

  • 🇳🇿New Zealand quietone

    I have read the IS and the comments. I see that the D10.0 release notes have been updated, so that is fixed.

    The remaining question is what to do for the next major release. The suggested text in #19 includes a question which I would rather not have in the release notes. So how to fix that. What I have done is updated the draft Drupal 11.0 release notes with the following.

    Refer to for how to perform a major version upgrade of Drupal.

    That is the top level Guide and thus has all the specific sub-pages people may need. I left a comment suggesting that a link may be needed to any specific Drupal 10 -> Drupal 11 page that may be created. I also left a comment in the draft notes pointing to this issue. I think that covers the release notes part of this.

    That leaves #19. I'll ask the other release managers for their views.

  • Status changed to Needs review 10 months ago
  • 🇳🇿New Zealand quietone

    I've updated the release note drafts with this:

    Refer to the guide Upgrading Drupal for how to perform a major version upgrade. And to Preparing your site for an upgrade for tools you can use to check the Drupal 11 compatibility of modules, themes and sites.

  • Status changed to Fixed 4 months ago
  • 🇳🇿New Zealand quietone

    I tested the commands on the 110.0 release page and found that that all work to update a site. The most challenging was using a site pinned at 10.0.1. For that I had to follow the link to the doc page to unpin first but after that was done the update proceeded without error.

    Therefor, closing this now. Re-open if I missed anything.

  • Automatically closed - issue fixed for 2 weeks with no activity.

Production build 0.71.5 2024