>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #1921152. --> Reported by: [nick_schuch](https://www.drupal.org/user/1412036) >>> <p>Follow up for <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/tour/-/work_items/1920468" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/tour/-/work_items/1920468</a></span></p> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>The Tour module is in Core, but we have very few tours in Core that use it.</p> <p>Note: We actually are unsure whether Tours are actually beneficial -- Tour hasn't been usability tested (see comment #141).</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>* Decide what tours would be beneficial.<br> * Agree upon standards for tours.<br> * Create tours.<br> * Commit them to Core.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <h4>Task A: Decide what tours would be beneficial</h4> <p>Some ideas for tours:</p> <ol> <li>Initial Experience <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/tour/-/work_items/1920468" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/tour/-/work_items/1920468</a></span></li> <li>Blocks <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/1926294" title="Status: Closed (fixed)">#1926294: Write tour integration for block_content.module</a></span></li> <li>Fields <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/1960824" title="Status: Closed (fixed)">#1960824: Write tour integration for Field UI module</a></span></li> <li>Views - some done in <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupal/issues/1809352" title="Status: Closed (fixed)">#1809352: Write tour.module and add it to core</a></span> (needs an issue to finish/polish the views part)</li> <li>Multilingual <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/1940590" title="Status: Closed (fixed)">#1940590: META: Write a multipage multilingual tour</a></span> (broken out into sub-issues for different module features)</li> <li>Appearance <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2040375" title="Status: Closed (fixed)">#2040375: Write tour integration for Appearance pages</a></span> </li><li>Structure <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-6"><a href="https://www.drupal.org/project/drupal/issues/2040791" title="Status: Closed (works as designed)">#2040791: Write tour integration for Structure page</a></span> </li><li>Content <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2040817" title="Status: Closed (fixed)">#2040817: Write tour integration for admin/content</a></span> </li><li>Add/edit content <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2044397" title="Status: Closed (fixed)">#2044397: Write tour integration to add/edit content UI</a></span></li> <li>Menu <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2040823" title="Status: Closed (fixed)">#2040823: Add tour integration for Menu admin page</a></span> </li><li>Reports <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2040833" title="Status: Closed (fixed)">#2040833: Write tour integration for Dblog page</a></span> </li><li>People <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2040845" title="Status: Closed (fixed)">#2040845: Write tour integration for People page</a></span> </li><li>Extend <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2040861" title="Status: Closed (fixed)">#2040861: Write tour integration for Extend (Modules) admin page</a></span> </li><li>Edit user <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2044399" title="Status: Closed (fixed)">#2044399: Write tour integration for user edit page</a></span> </li><li>Shortcuts <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/tour/issues/2044407" title="Status: Closed (fixed)">#2044407: Write tour integration for shortcuts page</a></span> </li><li>Forums <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/forum/-/work_items/1926296" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/forum/-/work_items/1926296</a></span></li> </ol> <p>From comment #130 -- @xjm's idea: Some obvious candidates for tours:</p> <ul> <li>Each tab of the Field UI (and explanation of the tabs themselves).</li> <li>The Extend page.</li> <li>The Block UI (although the work on Layouts might eventually deprecate this page).</li> <li>The Workflow UI.</li> <li>The Appearance page.</li> </ul> <p>Other thoughts on what tours to create:</p> <ul> <li>Modules that implement hook_help(). Can some/all of the content be converted to tips? <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/tour/-/work_items/1920470" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/tour/-/work_items/1920470</a></span></li> <li>Modules with routes. If it implements a page then there is a good chance it will also want to provide tips.</li> <li>Some pages may just need a hook_help() text (which goes in the Help block) rather than a full tour -- the help block doesn't require you to click on a Tour button to get the help displayed.</li> <li>Creating a tour for an admin page should not be a substitute for fixing usability problems on the page</li> <li>@yoroy's list of "conceptual criticals": <a href="http://yoroy.com/pieces/drupal-ux-conceptual-criticals">http://yoroy.com/pieces/drupal-ux-conceptual-criticals</a></li> </ul> <p>Check for<br> - <a href="https://drupal.org/project/issues/search/drupal?status%5B%5D=Open&amp;version%5B%5D=8.x&amp;issue_tags=Tour">open issues tagged with tour</a><br> - <a href="https://drupal.org/project/issues/search/drupal?status%5B%5D=Open&amp;version%5B%5D=8.x&amp;component%5B%5D=tour.module">Tour module issues</a></p> <h4>B: Create tours</h4> <p>Each tour that we want to create should be given an issue (if it doesn't already have one; or un-postpone existing issues).</p> <p>Here are some links about creating tours:</p> <ul> <li><a href="https://www.drupal.org/contributor-tasks/create-tour"><strong>Step-by-step guide for creating tours</strong></a>, usable by programmers or non-programmers</li> <li>The <a href="https://drupal.org/project/tour_ui">Tour UI</a> module</li> <li><a href="https://www.drupal.org/node/2000088">General usability guidelines for tours</a></li> <li><a href="https://www.drupal.org/node/2040099">Text standards for tours</a></li> <li><a href="https://www.drupal.org/node/604342">User interface standards for tours</a></li> <li><a href="https://www.drupal.org/docs/8/api/tour-api/overview">Tour API overview</a> -- warning: This is advanced, programmer-oriented information </li><li><a href="https://www.drupal.org/documentation/modules/tour">"Official" Tours doc page (needs work)</a></li> </ul> <h4>C: Update the standards for tours</h4> <p>We currently have 3 pages that talk about standards for tours. They haven't been reviewed recently, and should be:</p> <ul> <li><a href="https://www.drupal.org/node/2000088">General usability guidelines for tours</a></li> <li><a href="https://www.drupal.org/node/2040099">Text standards for tours</a></li> <li><a href="https://www.drupal.org/node/604342">User interface standards for tours</a></li> </ul> > Related issue: [Issue #2030661](https://www.drupal.org/node/2030661) > Related issue: [Issue #1945414](https://www.drupal.org/node/1945414)