Review guided tour and collect feedback from testers

This task is to collect feedback from testers of the guided tour.

Testers can be staff or ambassadors.

To open the guided tour: click on the help icon in the left menu after logging in with a staff or ambassador account.

---

Migrated from T3437 (view on Phabricator)

mentioned in merge request !595 (closed)

assigned to @moranegg

marked this issue as related to #3202

added Web app priority:Normal labels

Thanks @anlambert for this very intuitive guided tour!

Here are my comments:

1. the first 2 slides are redundant (welcome + homepage) - keep only welcome
2. usage of "that" can be reduced:

• slide 'help icon' - switch 'that' with 'the'
• that for => you can
• that list => the list / here

3. Visit software origin: switch "You can visit the software origin URL where source code was captured from by following that link." to "You can go directly to the source by clicking on the icon"
4. Origin visit date: delete second sentence
5. As @ardumont suggested in the parent task, delete "here" from the tabs slides and directly have "You can" (also on branch tip revision)
6. in Get SWHIDs of browsed objects: delete text and have something about the SWHIDs:

The **SWHID** (Software Heritage Identifier), is an intrinsic identifier that is computed uniquely from the software artifact itself.
All details about the syntax, semantics, interoperability and implementation can be found in [the formal specification](https://docs.softwareheritage.org/devel/swh-model/persistent-identifiers.html).

7. is it possible to show the difference of the SWHID with and without context?
8. I think that the "Select archived object type" slide is hard to understand if you don't know the archive (let's see how the ambassadors react to it)
9. In "Browsing a source code file"- change to:

• You just arrived in the source code file view. Let's check a few extra features

10. Be clearer that an action from the user is needed in "Highlight a source code line", make the text for the action in bold

• Now it is your turn to try: Click on the line number to highlight the corresponding line of code.

11. same in "Highlight a range of source code lines" : make the text for the action in bold
12. slide "End of guided tour";

• change title to "Guided tour completed"
• change text to "Thank your for following our guided tour !"
• I wasn't redirected at the end of the tour as suggested in this text "You will be now redirected to the page you were browsing prior launching it."

mentioned in commit 481647f8

13. after the lines slides, you can imagine how it is a qualifier on a SWHID but you can't see it. Might be useful to open again the permalink box to see.

Feedback is collected here: https://docs.google.com/document/d/1V35FMNcOvT6YUeiSXYse1g_0PqEoQFIc2GtPWPQHIOw/edit?usp=sharing

mentioned in commit 2a646e0e

The guided tour is now in production, so this task could be closed.

Nevertheless, here is some extra input coming from interaction with new users at the ICSME 2022 conference:

1. they found the guided tour super well done and helpful

2. it was suggested to add tooltips wih information on the different items visible in the interface: e.g. when you rest your mouse over the "visit" tab for a while, a tooltip would show a message similar to the one in the guided tour.

3. the guided tour is not starting up by default when the newcomers first visited the archive: we should turn this back on.