Upgrade Your Drupal Skills
We trained 1,000+ Drupal Developers over the last decade.
See Advanced Courses NAH, I know EnoughGuided Help Tours in Drupal 8 (sort of)
I was drawn to investigating the Tour module because I love ways of helping people through documentation. The Drupal core help system is an old system, and there have been many discussions and attempts to update it in the past. Tour certainly doesn't replace the help pages at this point, but it is an interesting new tool. So what exactly is going on with it in Drupal 8? Will we have a fancy new tours all over a default installation? Well, no. As it stands right now, there is only one tour in Drupal 8, which is for the Views building interface. It was submitted as a proof of concept with the Views module in core. So what's the deal?
There are a number of guidelines for when and how to write tours, but for many people the purpose and correct implementation of the tours is still not quite clear. There are three pieces to grok to create core tours right now:
- UI Patterns for Tours: this page describes the use cases and general principles for how tours should be used.
- Tour Text Standards: this page gets into the actual text of the tours and the things you should keep in mind while writing them.
- Tour API in Drupal 8: this is the required documentation to actually write the code to create a patch for Drupal core.
I dare say that once people can agree on the correct usage of the Tour module, and start writing them out, that getting developers to help turn them into code will be a pretty straight-forward process. Again, this isn't a technical problem really. We need to be clear about why we introduced Tour into core, and how we expect people to use it so folks can dive in to actually using it. It would be a sad thing to have the API in core, but not much implementation to actually help the end users that it was intended for.
About Drupal Sun
Drupal Sun is an Evolving Web project. It allows you to:
- Do full-text search on all the articles in Drupal Planet (thanks to Apache Solr)
- Facet based on tags, author, or feed
- Flip through articles quickly (with j/k or arrow keys) to find what you're interested in
- View the entire article text inline, or in the context of the site where it was created
See the blog post at Evolving Web