Viewing posts tagged documentation

Applying Lessons from the User Guide to Drupal Documentation

There's been an ongoing discussion about the state of documentation on Drupal.org. Sparked by this blog post by Matthew Grasmick which examines Drupal's failure to provide easy-to-follow installation documentation. To which Dries responded suggesting that we consider how we might evolve Drupal's documentation leadership and governance. I thought it would be worthwhile to share some of the lessons learned helping with the Drupal 8 User Guide in order to move the conversation forward.

Twig Filters: Modifying Variables in Drupal 8 Template Files

Something that's super fun about my job is that occasionally I get tasked with things like, "Learn how Twig works so you can tell us how it fits into our curriculum plans.". And I get to spend some time exploring various new features in Drupal 8, with an eye towards being able help explain them.

Guided Help Tours in Drupal 8 (sort of)

One of the neat new things in Drupal 8 is something called the Tour module. It is built on the Joyride jQuery plugin, which provides a clickable tour of HTML elements on your website. It gives you a way to walk a new user through your site or a particular interface with text instructions and next buttons. If you're not sure what this all means or looks like, have a look at the video below to see it in action in Drupal 8.
 
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?
 

Release Day: Free Community Videos to Kickstart Your Year

Happy New Year! We're kicking off 2013 with some FREE videos to get people up and running with our Drupal community tools. There are a lot of aspects of the Drupal community that many people take for granted. Even something as "simple" as figuring our what community websites are out there, and how to use them, is often overlooked when talking to people new to Drupal. So, if you want to really dive into this Drupal thing in 2013, here is a gentle orientation to help get you started.