Problem/Motivation

/admin/modules/install in D8 links to the "Handbook" via drupal.org/getting-started/install-contrib, a URL which redirects to an outdated D7 page when better resources such as the new User Guide chapter exist.

For Drupal 7 users at least, I don't think changing the redirect is a problem; a quick check shows even with the Update Manager module enabled it doesn't use the 'getting-started' link. (Though I've not searched the source code.)

Proposed resolution

The relevant code is in /core/modules/update/update-manager.inc and a patch would be trivial, however the user guide links are country-specific, but there are only 5 versions and should you use a link to a country that doesn't exist you get a 404, rather than a redirect to canonical version, i.e. 'en'.

Remaining tasks

Discussion by community (docs team? UX? drupal.org?)
- happy the new guide is better?
- do we patch core, or keep the getting-started/install-contrib redirect but change where that points to?
- can we go ahead anyway despite i18n issue with user guide links?

User interface changes

New link or change existing redirect on /admin/modules/install

API changes

None.

Data model changes

None.

Comments

wturrell created an issue. See original summary.

wturrell’s picture

wturrell CreditAttribution: wturrell as a volunteer commented

N:B technically the component for this should be update.module, but it would seem to make more sense for documentation people to look at it.
Also I'm not sure if it counts as a task or a bug…

wturrell’s picture

wturrell CreditAttribution: wturrell as a volunteer commented
Title: "Handbook" link on » "Handbook" link on /admin/modules/install outdated

Fix title.

Version: 8.3.x-dev » 8.4.x-dev

Drupal 8.3.0-alpha1 will be released the week of January 30, 2017, which means new developments and disruptive changes should now be targeted against the 8.4.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.4.x-dev » 8.5.x-dev

Drupal 8.4.0-alpha1 will be released the week of July 31, 2017, which means new developments and disruptive changes should now be targeted against the 8.5.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.5.x-dev » 8.6.x-dev

Drupal 8.5.0-alpha1 will be released the week of January 17, 2018, which means new developments and disruptive changes should now be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.6.x-dev » 8.7.x-dev

Drupal 8.6.0-alpha1 will be released the week of July 16, 2018, which means new developments and disruptive changes should now be targeted against the 8.7.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.7.x-dev » 8.8.x-dev

Drupal 8.7.0-alpha1 will be released the week of March 11, 2019, which means new developments and disruptive changes should now be targeted against the 8.8.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.8.x-dev » 8.9.x-dev

Drupal 8.8.0-alpha1 will be released the week of October 14th, 2019, which means new developments and disruptive changes should now be targeted against the 8.9.x-dev branch. (Any changes to 8.9.x will also be committed to 9.0.x in preparation for Drupal 9’s release, but some changes like significant feature additions will be deferred to 9.1.x.). For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.9.x-dev » 9.1.x-dev

Drupal 8.9.0-beta1 was released on March 20, 2020. 8.9.x is the final, long-term support (LTS) minor release of Drupal 8, which means new developments and disruptive changes should now be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Kristen Pol’s picture

Kristen Pol
she/her
Primary language English
Location Santa Cruz, CA, USA
CreditAttribution: Kristen Pol at Hook 42 commented
Status: Needs review » Active
Parent issue: » #2855175: [META] Many documentation / handbook URLs redirect to D7 content

Moving to Active because there is no patch yet. Moving this to a child of #2855175: [META] Many documentation / handbook URLs redirect to D7 content for now though it's not yet clear if that issue will become a "meta" issue.

Kristen Pol’s picture

Kristen Pol
she/her
Primary language English
Location Santa Cruz, CA, USA
CreditAttribution: Kristen Pol at Hook 42 commented
Category: Task » Bug report
Issue tags: +Bug Smash Initiative

I would argue this is a bug so reclassifying.

davidhernandez’s picture

davidhernandez
Primary language English
Location USA
CreditAttribution: davidhernandez at FFW commented
Status: Active » Closed (outdated)

I'm assuming this isn't relevant any more. The links I find in update manager all now point to D8 urls and they redirect to the main handbook extend documentation, not an outdated D7 page.