So Drupal 8 has that lovely tour module thing that does a little tour of the UI.

I wonder if there's a backport for 7.x or something very similar that would allow us to create a tour.

It would be great to go through servers, platforms and sites and quickly explain what they are on the first login of Aegir I think.

Comments

clemens.tolboom’s picture

This is possible with https://drupal.org/project/joyride which refers to Drupal 8 core Tour

I took part with the Tour (UI) and writing tours. It is not trivial writing tours. And it certainly does not need a developer writing tours ;-)

Steven Jones’s picture

Thanks for the link to the project.

Can you clarify:

It is not trivial writing tours.

and

And it certainly does not need a developer writing tours

So you're saying that it's a hard thing to do, but that we need to think carefully about the content, but don't need any development work?

ergonlogic’s picture

OA2 uses https://drupal.org/project/bootstrap_tour for something similar.

clemens.tolboom’s picture

@Steven Jones I'm not sure how joyride is configured. If similar to core tour one need to edit (config, json/yml) files.

But yeah it's hard to write the right tour. See my comment in #1921152-57: META: Start providing tour tips for other core modules..

The other day I talked to a trainer about our tours. From his questions I guess we are

building system oriented tours instead of solution oriented tours
basic tours as opposed to advanced tours as we have no choice to select the skill level
As I'm a coder I can only write system oriented basic tours but is that really what we need?

and Bohjan's response in #1921152-58: META: Start providing tour tips for other core modules..

I think that we should have researched what key user journeys we wish to provide with tours, and then written tours - now we are in the whisy-washy approach of, doing whatever until people object. I'd gladly help provide that direction, but so far I have had little interaction with those writing tours.

@ergonlogic I ran into bootstrap_tour first time today. It looks awesome, is used by more sites and has an tour editor.

joestewart’s picture

bootstrap_tour looks nice.

Bryan also created Scout that is another Joyride implementation. It's in a sandbox https://drupal.org/sandbox/bryrock/2153909

Steven Jones’s picture

Okay okay, technical issues aside: is this a good idea? What things should we have as part of a 'tour'?

clemens.tolboom’s picture

My opinion would be only if you have a dedicated person focussed on usability. It's a tough job with lots of valid discussions. And will drain developers time.

Maybe it's a good idea to check with other distributions whether and how they help with on-boarding. Do they use tours or other ways like inline help, wizards etc?

Steven Jones’s picture

Well, I was only thinking of a simple tour that starts on the very first login of the root user, and basically takes the user through:

  1. Servers
  2. Platforms
  3. Sites

And basically just introduces them to the concepts and make sure they are happy.

Anyway, this is a nice to have, and is some polish on the top of a great Aegir 3, which is yet to be done!

ergonlogic’s picture

Status: Active » Needs work

I started on this based on bootstrap_tour: https://drupal.org/project/aegir_tour. I've given all the core maintainers, as well as Clemens, commit access to the project. I also added it to the makefile and profile.

One challenge currently is that we don't have easy to target CSS ids on different links, buttons and other page elements. This makes pointing the tour steps at the right bits more difficult. So we should probably look at Eldir and our Views to start adding such IDs (or unique classes). This will also help in Behat testing.

One other minor oddity is that launching a tour un-collapses the 'filter' field-set on the sites page.

clemens.tolboom’s picture

As I'm a coder I'm not sure I should write tours :p ... I currently have a Symfony project needing bootstrap_tour so I could lend a hand for the project.