maximising the effect of progressive disclosure
DESCRIPTION
Minimalism in technical documentation states that we should only deliver info that the user needs. But how can we know what each individual user already knows (and does not need)? The answer is: we cannot. And this is why we should use progressive disclosure techniques to optimize the help we offer to our customers, so that each individual customer can decide for himself whether more info is needed or not, and on which aspects more info is needed. There is one important catch: Implementing progressive disclosure can be a lot of work and be too costly to do. The solution to this budgetary problem is to use a well-defined structure in your content (preferably DITA) and an XSLT that automatically adds the required hooks and handles (triggers and targets) to make progressive disclosure work.TRANSCRIPT
maximising the effect of progressive disclosure
Jang F.M. Graat
!1
who is talking ?• Jang F.M. Graat
• 25+ years in Tech Comm
• FM, RH, oXygen
• DITA, XSLT, JS, CSS
• Minimalist
• Psychology, Philosophy
• Dutch world citizen
!2
minimalismbasic principles
!3
reading is never the goal
!4
action-oriented
!5
give the users only the information they need
!6
support error recovery
!7
the problem
!8
what do the users already know ?
various user levels
!9
which personas ?
!10
education, experience, ...
!11
only the user knows what s/he doesn't know
!12
progressive disclosureputting the users in control
!13
users know when to ask for more info
!14
interactive media allow triggers and targets
!15
problem: changing context
!16
wild goose chase
!17
option: disclosable content
!18
progressive disclosure
!19
UA meets UX meets UG
!20
GUI and UA design go hand in hand
Wikipedia: !
"Progressive disclosure is an interaction design technique often
used in human computer interaction to help maintain the focus of a user's
attention by reducing clutter, confusion, and cognitive workload.
This improves usability by presenting only the minimum data
required for the task at hand."
!21
basic techniques
!22
using web technology
tooltips
!23
expanding text
!24
drop-down content
!25
layered content
!26
embedded videos
!27
staged information
!28
guided tours
!29
some guidelines
!30
styling and wording create expectations
!31
for more information click here. !more information !more information: + security settings + firewall options + privacy protection !
import/export options
focus of user's attention
!32
consistency in styling and location of elements
!33
always supply a way back
!34
things to avoid
!35
stating the obvious
!36
too many options
!37
unhelpful advice
!38
expanding menus
!39
dynamic menus
!40
what makes it work ?some good and bad examples
!41
getting started
!42
!43
!44
!45
!46
!47
!48
!49
!50
embedded user assistance
!51
!52
!53
!54
!55
!56
!57
!58
!59
progressive disclosurehow to implement it (manually)
!60
!61
minimal information that is always shown
!62
RoboHelp allows drop-down text
!63
inserting and editing hidden information
!64
text is marked as hotspot
!65
the same process can be nested
!66
drop-down content may include images
!67
the end result in a browser: only minimal info is visible
!68
the user can click on triggers to reveal drop-down content
!69
progressive disclosure
!70
this method takes time
progressive disclosurelet's automate the process
!71
* the described automation will be available as a plug-in
for the DITA Open Toolkit
structure + XSLT = magic
!72
XPath : semantic search
!73
XSLT : makeover
!74
!75
task
title
shortdesc
prolog
taskbody
context
steps
step
cmd
info
substeps
stepresult
step
cmd
substeps
step
cmd
info
substeps
a DITA task red: mandatory green: optional
!76
DITA task in the editor
!77
standard HTML output
!78
XSL allows automatic
transformation
!79
<shortdesc> is changed into
a tooltip
!80
CSS makes specified elements
initially hidden
!81
JavaScript links triggers to their target content
!82
result of the XSLT
!83
output in a browser
!84
clicking a + symbols opens the <substeps>
!85
other symbols open <info> and <result>
!86
moving mouse over title reveals <shortdesc>
!87
+ symbol top right opens <context>
!88
further learning
Nielsen Norman group
!89
www.nngroup.com
questions ?www.jang.nl
4everJang
blogs.jang.nl
!90