>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #2186531. --> Reported by: [xjm](https://www.drupal.org/user/65776) >>> <p><em>Updated: Comment <a href="https://www.drupal.org#content">#0</a></em></p> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <ul> <li><a href="https://drupal.org/upgrade">https://drupal.org/upgrade</a> is the main documentation resource for upgrading Drupal sites, but it does not explain how to upgrade from D6 or D7 to D8 with migrate.</li> <li>Following <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupal/issues/2168011" title="Status: Closed (fixed)">#2168011: Remove all 7.x to 8.x update hooks and disallow updates from the previous major version</a></span>, <code>update.php</code> directs users to use the Migrate API to upgrade from versions prior to Drupal 8.0, but the message links to an API documentation page which is not helpful for non-developers.</li> </ul> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <ul> <li>Update <a href="https://drupal.org/upgrade/migrate">https://drupal.org/upgrade/migrate</a> to explain the D7 to D8 data migration process: Essentially, install a new Drupal 8 site, configure it to match the Drupal 7 site, and use the migration API to migrate data.</li> <li>For now, stub instructions would probably be sufficient, and they could be fleshed out as the Migrate initiative is completed. See <a href="https://drupal.org/node/2186315">Drupal 7 sites can no longer be upgraded to Drupal 8 with update.php</a> and <a href="https://drupal.org/sandbox/mikeryan/2271813">Migrate Upgrade UI Sandbox</a> for a start.</li> <li>Correct the links displayed in <code>update.php</code> to reference this handbook page instead of the API documentation. See <code>update_get_update_list()</code>.</li> </ul> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <ul> <li>Update <a href="https://drupal.org/upgrade/migrate">https://drupal.org/upgrade/migrate</a> based on the provisional UI <a href="https://drupal.org/sandbox/mikeryan/2271813">https://drupal.org/sandbox/mikeryan/2271813</a>. Be clear this is in development.</li> <li>Patch <code>update.php</code>, pointing to the updated handbook page. </li></ul> <h3 id="summary-ui-changes">User interface changes</h3> <p>If a site owner attempts to upgrade a Drupal 7 database to Drupal 8 using update.php, a more helpful requirements error will be displayed.</p> <!-- See https://drupal.org/core-mentoring/novice-tasks for tips on identifying novice tasks. Delete or add "Novice" from the Novice? column in the table below as appropriate. Uncomment tasks as the issue advances. Update the Complete? column to indicate when they are done, and maybe reference the comment number where they were done. --><table> <caption>Contributor tasks needed</caption> <thead> <tr> <th>Task</th> <th>Novice task?</th> <th>Contributor instructions</th> <th>Complete?</th> </tr> </thead> <tbody> <tr> <td>Create a patch</td> <td>Novice</td> <td> <a href="https://drupal.org/contributor-tasks/create-patch">Instructions</a></td> <td></td> <td></td> </tr> <!-- <tr><td>Reroll the patch if it no longer applies.</td><td></td><td> <a href="https://drupal.org/contributor-tasks/reroll">Instructions</a></td><td></td></tr> --><tr> <td>Add automated tests</td> <td>(necessary?)</td> <td> <a href="https://drupal.org/contributor-tasks/write-tests">Instructions</a> </td> <td></td> </tr> <!-- <tr><td>Draft a change record for the API changes</td><td></td><td> <a href="https://drupal.org/contributor-tasks/draft-change-record">Instructions</a></td><td></td></tr>&nbsp; --><!-- <tr><td>Improve patch documentation or standards (for just lines changed by the patch) </td><td>Novice</td><td> <a href="https://drupal.org/contributor-tasks/improve-patch-standards">Instructions</a></td><td></td></tr> --><tr> <td>Manually test the patch </td> <td>Novice</td> <td> <a href="https://drupal.org/contributor-tasks/manual-testing">Instructions</a></td> <td></td> </tr> <tr> <td>Update the issue summary </td> <td></td> <td> <a href="https://drupal.org/contributor-tasks/write-issue-summary">Instructions</a></td> <td></td> </tr> <!-- <tr><td>Add steps to reproduce the issue</td><td>Novice</td><td> <a href="https://drupal.org/contributor-tasks/add-steps-to-reproduce">Instructions</a></td><td></td></tr> --><tr> <td>Embed before and after screenshots in the issue summary </td> <td>Novice</td> <td> <a href="https://drupal.org/contributor-tasks/manual-testing">Instructions</a></td> <td></td> </tr> <tr> <td>Review patch to ensure that it fixes the issue, stays within scope, is properly documented, and follows <a href="https://drupal.org/coding-standards">coding standards</a></td> <td></td> <td> <a href="https://drupal.org/contributor-tasks/review">Instructions</a></td> <td></td> </tr> </tbody> </table> > Related issue: [Issue #2168011](https://www.drupal.org/node/2168011)