Problem/Motivation
Several links go to documentation for Drupal 7 instead of Drupal 8: for example, https://www.drupal.org/docs/7/install instead of https://www.drupal.org/docs/8/install.
Some links are redirected, and most have URL aliases as well as /node/... versions. The following table includes such variants.
Proposed resolution
Change the following links:
The following searches should show which files contain any of these links:
$ grep -irl "getting-started/install" core
core/tests/Drupal/FunctionalTests/Installer/InstallerTranslationTest.php
core/lib/Drupal/Core/Installer/Form/SiteSettingsForm.php
$ grep -irl "docs/7/install" core
$ grep -irl "node/2764151" core
$ grep -irl "documentation/install" core
core/INSTALL.txt
core/lib/Drupal/Core/FileTransfer/Form/FileTransferAuthorizeForm.php
$ grep -irl "extend/overview" core
$ grep -irl "node/176043" core
$ grep -irl "docs/7/multisite" core
$ grep -irl "node/251040" core
$ grep -irl "getting-started/clean-urls" core
core/INSTALL.txt
$ grep -irl "documentation/multilingual" core
core/INSTALL.txt
$ grep -irl "node/15365" core
core/modules/system/system.install
$ grep -irl "docs/7/system-requirements/" core
core/modules/system/system.install
As noted in #37, we should not update this reference, so we should get the same results before and after applying the patch:
$ grep -irB 1 "docs/7/" core
core/themes/seven/README.txt-To read more about the Seven theme's origins (in Drupal 7) please see:
core/themes/seven/README.txt:https://www.drupal.org/docs/7/core/themes/seven
This issue is just about updating the links. Some of them are explicit strings, like <a href="https://www.drupal.org/getting-started/install">installation handbook</a>, and others are arguments to the t() function, like t('... <a href=":link">Enable clean URLs</a>', [':link' => 'http://drupal.org/node/15365']). Being more consistent is out of scope for this issue, and may be a mistake. See Comment #22 below.
It is OK to expand the scope of this issue if you find addtional links that need to be updated. Just be sure to update the table and search results above. Let's not try to update every link that needs to be updated as part of this issue.
Remaining tasks
- Reroll the patch. See Comment #44 and Contributor task: Re-roll a Drupal core patch or Rerolling patches.
User interface changes
String changes
API changes
None
Data model changes
None