• Save
The changing nature of technical content (tekom tcworld 2013 conference)
Upcoming SlideShare
Loading in...5
×
 

The changing nature of technical content (tekom tcworld 2013 conference)

on

  • 377 views

There have been many developments in creating documentation systems, with the assumption that the nature of the content - the tone of voice, the writing style - should remain essentially the same. We ...

There have been many developments in creating documentation systems, with the assumption that the nature of the content - the tone of voice, the writing style - should remain essentially the same. We investigate whether the tried-and-tested technical communication writing styles from past decades still make sense today. We look at the reasons why some organisations, such as Facebook, Google & Mozilla, might be "breaking the rules" in the User Assistance they provide. We also look at how structured, adaptable, intelligent content becomes important for organisations that do decide to change.

Statistics

Views

Total Views
377
Views on SlideShare
368
Embed Views
9

Actions

Likes
0
Downloads
0
Comments
0

3 Embeds 9

http://techcommspeakersbureau.org 5
http://www.linkedin.com 3
https://www.linkedin.com 1

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

The changing nature of technical content (tekom tcworld 2013 conference) The changing nature of technical content (tekom tcworld 2013 conference) Presentation Transcript

  • The changing nature of content tekom tcworld 2013 Ellis Pratt Cherryleaf Saturday, 9 November 2013
  • Overview 1. A story 2. What do we mean by the traditional approach to User Assistance? 3. Why change? The weakness with the current approach 4. Towards a new model 5. What are the benefits for doing this? Saturday, 9 November 2013
  • 1. A story.... Saturday, 9 November 2013
  • We heard a prospect say Saturday, 9 November 2013
  • We heard a prospect say “We’d like our technical user documentation to be like our marketing documents... Saturday, 9 November 2013
  • We heard a prospect say “We’d like our technical user documentation to be like our marketing documents... friendly... Saturday, 9 November 2013
  • We heard a prospect say “We’d like our technical user documentation to be like our marketing documents... friendly... conversational... Saturday, 9 November 2013
  • We heard a prospect say “We’d like our technical user documentation to be like our marketing documents... friendly... conversational... good.” Saturday, 9 November 2013
  • We started to see this elsewhere Saturday, 9 November 2013
  • To get fancy with this, you can do use this in conjunction with the link tool when you’re creating your promotion. Just click the link tool above the module, and in the place where it says “Link name”, you could write: Join my mailing list. Then, where it says, “http://” and wants you to add you link, just insert [[subscribe]] and you’ll be golden. Saturday, 9 November 2013
  • Saturday, 9 November 2013
  • Setting your home page in Firefox is easy. Can't decide on just one page? No problem. Firefox lets you set a group of websites as your home page. This article will give you some examples and step-by-step instructions for customizing your home page settings to best fit how you work. Saturday, 9 November 2013
  • 13% increase Saturday, 9 November 2013
  • Was a new model emerging? New ! Saturday, 9 November 2013
  • 2. What do we mean by the traditional approach to User Assistance? Saturday, 9 November 2013
  • The traditional model Help image: HyperWrite Saturday, 9 November 2013
  • The traditional approaches Information Mapping Minimalism Quick Reader Comprehension STOP Sequential Thematic Organization of Publications From the 1950s-80s Image: Wikipedia Saturday, 9 November 2013
  • The traditional model Succinct Clear and unambiguous Numbered lists Topic-based writing Unemotional Active voice Saturday, 9 November 2013
  • Strengths Easy to understand Easy to find Translatable Accurate Re-usable Saturday, 9 November 2013
  • The traditional model is good for Safety Risk A hierarchical, command and control, culture Anxiety Image: Haynes Saturday, 9 November 2013
  • 3. Why change? Saturday, 9 November 2013
  • Who has been told this? “No-one reads the manual” Saturday, 9 November 2013
  • Why change? Uncertainty over its value Image: Kathy Sierra Saturday, 9 November 2013
  • Technology is changing We feel we are in more control Saturday, 9 November 2013
  • Technology is changing 1993 2013 It’s more ubiquitous Saturday, 9 November 2013 Image: Jim CarreyFar
  • Users are becoming more competent They want to do more than just function They want to master a task Saturday, 9 November 2013
  • What motivates people Autonomy - being in control of their lives Mastery - being good at something Purpose - something having meaning Saturday, 9 November 2013
  • How we purchase technology is changing Image: Google Saturday, 9 November 2013
  • Saturday, 9 November 2013
  • How we purchase technology is changing Know Like Trust Try Buy Saturday, 9 November 2013
  • How technology is sold is changing Try before you buy Software as a Service App abandonment Saturday, 9 November 2013
  • How we purchase technology is changing Know Technical content User Assistance Like Trust Try Buy Saturday, 9 November 2013
  • How technology is sold is changing This may not work any more Saturday, 9 November 2013
  • 4. Towards a new model Saturday, 9 November 2013
  • Let’s look at some examples Saturday, 9 November 2013
  • More submissive Saturday, 9 November 2013
  • More submissive Saturday, 9 November 2013
  • More conversational Saturday, 9 November 2013
  • More conversational Saturday, 9 November 2013
  • It’s happened before Saturday, 9 November 2013
  • But L18N needs took over Generated by CamScanner from intsig.com Saturday, 9 November 2013 2008
  • But L18N needs took over 2013 Saturday, 9 November 2013
  • Progress or regression? Saturday, 9 November 2013
  • The importance of psychology Image: University of Roehampton Saturday, 9 November 2013
  • The importance of context Image: Wikipedia Saturday, 9 November 2013
  • The importance of context Traditional, dominant approach Saturday, 9 November 2013
  • Developing a voice and tone MailChimp style guide VoiceandTone.com Saturday, 9 November 2013
  • Developing a voice and tone Saturday, 9 November 2013
  • Developing a voice and tone Saturday, 9 November 2013
  • Developing an integrated model for learning, User Assistance and mastery Saturday, 9 November 2013
  • The competence of users Unconscious competence Mastery I know how to do it well I know I’m incompetent Conscious incompetence I don’t know I’m incompetent Saturday, 9 November 2013 Conscious competence Unconscious incompetence
  • Traditional UA model Forums Screencasts Users’ questions & strategies Body of knowledge Making people aware of their “incompetence” Saturday, 9 November 2013 Help Training
  • A new design for User Assistance Users’ questions & strategies Community, user generated content Feed some of this back into What is a good choice? Body of knowledge Curiosity Making people aware of their “incompetence” Saturday, 9 November 2013
  • A unified system Users’ questions & strategies Community, user generated content Body of knowledge Making people aware of their “incompetence” Saturday, 9 November 2013
  • 5. What are the benefits for doing this? Saturday, 9 November 2013
  • What is our desired action? What do we measure? What is our definition of success? Saturday, 9 November 2013
  • What do we measure? Correlate with Support calls Ratings of usefulness Comments Usability testing Task completion Prospects become customers Saturday, 9 November 2013
  • A/B Split testing 13% reduction in Support calls Saturday, 9 November 2013
  • 6. What are the take-aways? Saturday, 9 November 2013
  • Summary Technology and users’ skill are changing The techniques from 30 years ago may no longer appropriate New writing styles are emerging Saturday, 9 November 2013
  • Summary No one right answer, you will need to experiment Saturday, 9 November 2013
  • More information Saturday, 9 November 2013
  • For more information (including details on our training course) ellis@cherryleaf.com @ellispratt Saturday, 9 November 2013
  • Questions? (I have Jammie Dodgers) Saturday, 9 November 2013
  • End © Cherryleaf 2013 Images and screenshots © their respective owners Saturday, 9 November 2013