Search

20 Jul 2011

Making Socially Enabled User Assistance Better– “Help” vs. ”HEEELP!”

Someone posted to the Content Strategy Google Group asking about Help content.  I didn’t have a lot of time so I pinged over my fav article going on Help these days: Scott Abel’s The Future of Technical Communication Is Socially Enabled: Understanding the Help 2.0 Revolution.

Then I did a runner…

Since, Dana Chisnell then challenged me:

Why are you providing help? Any time you have a separate system for the help, you're in trouble. Embedding the assistance in the UI and surfacing it when the user needs it will work much, much better.

Which is of course, preaching to the choir.  I couldn't be more in agreement.  

Socially enabled help almost immediately begets socially enabled embedded help.  It's only logical, and it’s not even my idea, it’s already happening. 

Smart companies generally (regardless of social enablement) are bringing user assistance (the posh word for Help these days) into the UX and the UI, not making it retrospective. 

On demand is good, but you want to assist users before they ‘demand’ it. In other words: Help should help, not wait until the user needs 'HEEELLP!' (Tweet that, I dares ya!)

The Problem With The World Today


Today the user assistance UX story is:

“What's that?  I can't figure out this UI! Now my User Experience is broken and I hate this company! HEEELP!

It should be:

'What's that?'


Helpful bit of content appears to the rescue!


'Oh. Ok. Now back to what I was doing'

I’m sure Scott’s probably got this in mind too as our brain children go to the same school of thought. It’s nice.  Lovely play areas and recess is 9 times a day.  And they serve the kids wine…

What you need to do


Anyway! If it wasn’t explicit enough, I’ll provide some detail (in my own words, so I don’t want anyone to think I’m speaking for Scott without permission).  Here’s Noz’s official to-do list for the Help World:

  • Help needs to be socially enabled (Scott’s already broke it down for you)
  • Help content needs to be brought into devices and UIs (hardware, software, website - whatever!) so that those with content skills work in harmonious partnership with those that have UI, UX and development skills. 
  • The application assistance architecture should be socially extensible so that the social components of help integrate nicely with the brand-generated components

Here’s some examples of companies that have it part right:

 

Adobe Photoshop Help Offline

image
Right-click and view/open in a new window to enlarge.


If you’re offline, hit F1 in PS and you go to a html-based help file (html, running offline from a folder on your computer).  Note the PDF link on top right! 

Defaultpagesayswhat? Community help!  In other words, to REALLY get the full experience, go online and join the party, silly!

Adobe Photoshop Help Online


Turn ye ol’ Net back on and Adobe takes you straight to a website that looks exactly the same, but new features abound! 

  • Feedback
  • Options to search through help for other applications
  • Still available as PDF!
  • Community intro link available (blue, bottom left)
  • Commenting
  • Comments RSS feed (subscribe to this piece of content!)
  • And so on… explore it yourself for fun.
image
Right-click and view/open in a new window to enlarge.


Good, but could be better.

Let’s compare with one of my favourite apps, Ableton Live:

 

Ableton Live Context Ultra-sensitive Help

ableton

Right-click and view/open in a new window to enlarge.


In Ableton, help is in panes within the UI.  Once you’re experienced user, you hide them both away and only bring them back as needed.

  • Big stuff like tutorials, walkthroughs, set-up instructions, is on the right in the main help pane (F1).
  • Bottom left we have a little hide-able pane that constantly pops helpful information and short-cuts for ANYTHING I hover my mouse over (the 'Live Device Browser' in this case).  That is to say, new users just leave that baby open, and you instantly know what every UI item works, and the short-cut for triggering it:




Compare this to user's alternative workflow:


'What's this? How do I use it?'

Learns how to use it is somehow. By looking it up? Probably not...
Starts getting into productive work...


'Showing and hiding this thing is annoying....
Hmmm...maybe there's a short-cut...?
Do I want to stop what I'm doing and look it up?
No.
Actually, yes... this is annoying...I'll go look it up!'

...and how mad are they going to be if it turns out there is no short-cut after all? 

The Promised Land


Of course, we should bring the two together, so that the web snazzies of Adobe’s help appear in the UI like Ableton.  In time dear friends, but fear not, that is where we’re heading!

Agree? Disagree?  Let me have it in the socially-enabled comments!

UPDATE!

Dana pointed out I forgot to mention mobile devices and hit me with this great soundbite:

"...we should all be thinking about what will work on the tiny screen that will scale up, not the other way around."

I also forgot to mention:

  • Great help doesn't mean UI/UX designers can all start leaving work at 3pm! The idea is to avoid needing to get help in the first place, no matter how nicely it's delivered.
  • Those implementing DITA or any other Component CMS platform should be thinking about how this social content gets round-tripped back into source so that the brand-sourced content, service desk knowledge-bases, intranets, and the product itself are all improved by leveraging the crowd's contributions.

19 Jul 2011

Time Go Bye Bye, DITA Training, Largest DITA Project Ever

Wow...

Time has just... gone!

It seems like last week I was delivering my opening address, somewhat exhausted, at Congility 2011.

The event wasn't even over and we were letting people know about the DITA Training courses on offer at Congility South.  Not to mention my having to prepare the course itself.

A heartbeat after I was whisked away to begin work on what is one of the largest DITA Content Management projects of my career, and the biggest Content Technology Audit (CTA, similar to a Content Strategy Audit but systems-focussed) I've ever done.  They have 1000 (one THOUSAND) dedicated technical authors worldwide with 10,000 (you heard me) engineers looking to contribute natively into DITA topics.   They said full roll-out numbers might be 30,000 users globally. If we opt to go for direct Engineer contributions, they will have more DITA authors than most companies have staff!

Oh, and they're working off the file system - no CMS support.

DITA Gone Wild


It's been a fascinating example of DITA pushed to the limits.  They products are set up in a 'platform>product' way where specific products are built off the platforms, so there is extensive reuse.  But:

  • They various builds of the software run in parallel, meaning there's reuse from platforms but also any number of parallel builds of the software
  • The need to keep maintaining all the various versions - current, plus 2 versions back
  • They have to reuse extensively into training materials
  • There's hardware too...
  • Oh... and just for fun, it's full of client-specific stuff

They're handling this all with extensive branching and merging, and more conditions than I've ever seen.  They're conditionalising content by:

  • Version - because of all the branching and parallel development, different versions are considered different products
  • Audience - Including the employees, the public, and customers
  • Outputclass: e.g., chm and pdf
  • Platform - what base platform is the product derived from

Single lines like 'The XYZ product can boil a chicken in 5 minutes if you press the "boil" button' might be conditionalised to the point where it can say:
  • The XYZ23 product can boil, or broil a chicken in 5-10 minutes if you press the "cook" button
  • The XYZ27 product can cook a chicken in 15 minutes automatically
  • The ABC123 product can boil a turkey in 20 minutes if you press the "boil" button
  • The 321CBA product can nuke a turkey, squab or chicken if you press the "Angry birds" button

And so on, and so on and so on aaand so on... 

Imagine working on the sentences while looking at a document module (DITA Topic) where all that is being expressed simultaneously. and then sharing modules like that that were created by other people for use in your documents.  Without a database...

What is amazing is how well they're managing.  I have amazing respect for what they've already accomplished.  Now they've asked for help to go from managing to optimising and really tuning for the customer's interests. 

I'll let you know how we get on. 

Overall I'm really enthused by seeing such a huge DITA project be a success, and now, having the opportunity to help take it to the next level.  Lame, but that gives me the warm and squishies inside.

Geek corner


For the nerds out there, I'm seeing now just how interesting DITA Keys and Conkeyref are to the scalability of reuse, especially combined with Conditions.  I'm upping the focus on them significantly at Congility South.

Also, I've finally got a little workshop together on Context-sensitive help in DITA.  I had a real developer build me an actual application that I can use to demonstrate the concepts and make new context sensitive help on the fly for various formats from DITA source

Now I just need to work out how to use it to teach conditions as well... and make it call a website instead of a local help file...

  

By: TwitterButtons.com