>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #2857156. --> Reported by: [jhodgdon](https://www.drupal.org/user/155601) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>The User Guide needs a new branch and release, 8.x-3.x, to correspond with Drupal Core 8.3.x.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Make a new branch, and update text and screenshots as necessary.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <p>* [DONE] Make a new 8.x-3.x branch in the Git repository.</p> <p>* [DONE] Run the screenshots/tests scripts in existing languages:<br> - Update database dumps.<br> - Update screenshots that have changed.<br> - [no updates needed] See if any user interface text or steps in the User Guide need to be updated (hopefully the tests/scripts that generate the screenshots will fail if updates are needed, so we will notice).</p> <p>[ALL DONE] Languages to test/update:<br> -- [DONE] English (en)<br> -- [DONE] Catalan (ca)<br> -- [DONE] Hungarian (hu)<br> -- [DONE] Simplified Chinese (zh-hans)</p> <p>* [DONE] Create screenshots and database dumps for two new languages:<br> -- [DONE] French (fr): <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/user_guide/-/work_items/2837539" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/user_guide/-/work_items/2837539</a></span><br> -- [DONE] Japanese (ja): <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-8"><a href="https://www.drupal.org/project/user_guide/issues/2885310" title="Status: Needs review">#2885310: [JA] Japanese screenshots</a></span></p> <p>(The other 5 language groups that are translating the User Guide have not yet requested automated screenshots be created and/or provided the text for the Farmer's Market scenario that is used in the screenshots.)</p> <p>* [DONE] Make an 8.x-3.0 release with e-book output</p> <p>* [DONE] Get the new 8.x-3.x User Guide deployed to drupal.org</p> <h3>List of 8.3.x changes</h3> <p>Here is a list of topics and screenshot images that needed updates in 8.3.x:<br> - The tests/scripts required some minor updates for technical behind-the-scenes changes in Drupal.<br> - Many images had minor changes that didn't affect understanding, but they were updated to reflect the latest Drupal (after verifying the User Guide text didn't need an update).<br> - A few administrative pages got redesigned in 8.3.x, such as the major redesign of the Status Report page. Other pages had less drastic changes. Nothing required changes to the User Guide text, just updated screenshots.</p> <h3>Original report...</h3> <p>This issue is to remind me that when Drupal core 8.3.0 is released (it's in the Release Candidate phase now), we probably need to make a corresponding 8.x-3.x branch of the User Guide.</p> <p>Probably some of the UI text has changed. The tests that were added in <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/user_guide/-/work_items/2782897" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/user_guide/-/work_items/2782897</a></span> will catch most changes (but probably not all). So, we should run the automated tests and see if any of them fail, and make updates to the Guide text as needed. We also may need to update some screenshots, correspondingly.</p> <p>One thing I know changed in 8.3.x from 8.2.x is that the Status Report was redesigned. The tests will not capture that change, but we should make a new screenshot for that topic (in the Preventing and Fixing Problems chapter).</p>