– A tour through tour.module – Backstory



– A tour through tour.module – Backstory

0 0


tour-slides

Slides for "A tour through tour module"

On Github nickschuch / tour-slides

A tour through tour.module

The presenter - Nick schuch

  • Drupal:
    • nick_schuch - https://drupal.org/user/1412036
    • http://previousnext.com.au/blog/author/nick_schuch
    • http://nickschuch.com
  • Twitter:
    • @sanic1989
    • #d8tour
  • IRC: nick_schuch
    • #drupal-contribute
    • #drupal-tour

Overview

  • Backstory
  • Demo
  • The state of tour
  • Writing tours
  • Extending tour
  • Writing test coverage
  • How to write test coverage for tips
  • How you can contribute
  • Where can I find more

Backstory

  • Drupal.org issue queue
  • Office colleagues hatch a plan
  • Early prototype developed and posted on Drupal.org
  • Drupalcon Sydney sprinting
  • Cornering Dries in the elevator to demo feature
  • Committed!

To find out more:

PreviousNext blog series

  • http://previousnext.com.au/blog/tour-module-part-1-journey-adding-drupal-feature
  • http://previousnext.com.au/blog/tour-module-part-2-creating-tour-your-module

Demo

It's demo time!

The state of tour

Committed to D8 core!

Picture of commit here.......

We have sprinted.

  • DrupalGov
  • Sydney meetup sprint
@todo, Need to get a list of the other sprints.

Javascript is very simple now overlay has been removed.

Taken from: https://groups.drupal.org/node/397733

It's time to start writing tips

Writing tours

Example

<font style="font-size: 24px;">id: person-add
module: node
label: Explain how to add a person node.
langcode: en
paths:
  - node/add/person
tips:
  first-name:
    id: first-name
    plugin: text
    label: First name
    body: Please enter your first name here.
    weight: "1"
    attributes:
      data-class: field-first-name </font>            

What do I do with this file?

  • Import the file for testing or bulk import of tour tip content.
@todo, Screen capture of import goes here.
  • Add the file to a module. The tour and the code go hand in hand.
@todo, Screen capture of directory structure goes here.

Time for a demo!

Witting slide goes here......

Extending tour

Some examples of tour tip types

  • Video (youtube, vimeo etc)
  • Music
  • Image's
  • Embeddable content (eg. Node display)
  • .....
  • .....
  • .....
  • .....
  • Limitless.

Example

Find a way to fit the example in here.......

Time for a demo!

Writing test coverage

Why do we write tests?

Example

Time to demo!

How you can contribute

  • Write tour's for core
  • Provide screenshots with tour content for someone to write
  • Write test coverage for other's that cannot
  • Contribute to documentation
  • Blog posts
  • Tweet about it with #d8tour
  • Come to the weekly scrums (bring a friend!)
  • Join #drupal-tour

Where can I find more information?

Thankyou