maximising the effect of progressive disclosure

90
maximising the effect of progressive disclosure Jang F.M. Graat 1

Upload: jang-fm-graat

Post on 18-Nov-2014

249 views

Category:

Technology


1 download

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

Page 1: Maximising the effect of progressive disclosure

maximising the effect of progressive disclosure

Jang F.M. Graat

!1

Page 2: Maximising the effect of progressive disclosure

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

Page 3: Maximising the effect of progressive disclosure

minimalismbasic principles

!3

Page 4: Maximising the effect of progressive disclosure

reading is never the goal

!4

Page 5: Maximising the effect of progressive disclosure

action-oriented

!5

Page 6: Maximising the effect of progressive disclosure

give the users only the information they need

!6

Page 7: Maximising the effect of progressive disclosure

support error recovery

!7

Page 8: Maximising the effect of progressive disclosure

the problem

!8

what do the users already know ?

Page 9: Maximising the effect of progressive disclosure

various user levels

!9

Page 10: Maximising the effect of progressive disclosure

which personas ?

!10

Page 11: Maximising the effect of progressive disclosure

education, experience, ...

!11

Page 12: Maximising the effect of progressive disclosure

only the user knows what s/he doesn't know

!12

Page 13: Maximising the effect of progressive disclosure

progressive disclosureputting the users in control

!13

Page 14: Maximising the effect of progressive disclosure

users know when to ask for more info

!14

Page 15: Maximising the effect of progressive disclosure

interactive media allow triggers and targets

!15

Page 16: Maximising the effect of progressive disclosure

problem: changing context

!16

Page 17: Maximising the effect of progressive disclosure

wild goose chase

!17

Page 18: Maximising the effect of progressive disclosure

option: disclosable content

!18

Page 19: Maximising the effect of progressive disclosure

progressive disclosure

!19

Page 20: Maximising the effect of progressive disclosure

UA meets UX meets UG

!20

GUI and UA design go hand in hand

Page 21: Maximising the effect of progressive disclosure

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

Page 22: Maximising the effect of progressive disclosure

basic techniques

!22

using web technology

Page 23: Maximising the effect of progressive disclosure

tooltips

!23

Page 24: Maximising the effect of progressive disclosure

expanding text

!24

Page 25: Maximising the effect of progressive disclosure

drop-down content

!25

Page 26: Maximising the effect of progressive disclosure

layered content

!26

Page 27: Maximising the effect of progressive disclosure

embedded videos

!27

Page 28: Maximising the effect of progressive disclosure

staged information

!28

Page 29: Maximising the effect of progressive disclosure

guided tours

!29

Page 30: Maximising the effect of progressive disclosure

some guidelines

!30

Page 31: Maximising the effect of progressive disclosure

styling and wording create expectations

!31

for more information click here. !more information !more information: + security settings + firewall options + privacy protection !

import/export options

Page 32: Maximising the effect of progressive disclosure

focus of user's attention

!32

Page 33: Maximising the effect of progressive disclosure

consistency in styling and location of elements

!33

Page 34: Maximising the effect of progressive disclosure

always supply a way back

!34

Page 35: Maximising the effect of progressive disclosure

things to avoid

!35

Page 36: Maximising the effect of progressive disclosure

stating the obvious

!36

Page 37: Maximising the effect of progressive disclosure

too many options

!37

Page 38: Maximising the effect of progressive disclosure

unhelpful advice

!38

Page 39: Maximising the effect of progressive disclosure

expanding menus

!39

Page 40: Maximising the effect of progressive disclosure

dynamic menus

!40

Page 41: Maximising the effect of progressive disclosure

what makes it work ?some good and bad examples

!41

Page 42: Maximising the effect of progressive disclosure

getting started

!42

Page 43: Maximising the effect of progressive disclosure

!43

Page 44: Maximising the effect of progressive disclosure

!44

Page 45: Maximising the effect of progressive disclosure

!45

Page 46: Maximising the effect of progressive disclosure

!46

Page 47: Maximising the effect of progressive disclosure

!47

Page 48: Maximising the effect of progressive disclosure

!48

Page 49: Maximising the effect of progressive disclosure

!49

Page 50: Maximising the effect of progressive disclosure

!50

Page 51: Maximising the effect of progressive disclosure

embedded user assistance

!51

Page 52: Maximising the effect of progressive disclosure

!52

Page 53: Maximising the effect of progressive disclosure

!53

Page 54: Maximising the effect of progressive disclosure

!54

Page 55: Maximising the effect of progressive disclosure

!55

Page 56: Maximising the effect of progressive disclosure

!56

Page 57: Maximising the effect of progressive disclosure

!57

Page 58: Maximising the effect of progressive disclosure

!58

Page 59: Maximising the effect of progressive disclosure

!59

Page 60: Maximising the effect of progressive disclosure

progressive disclosurehow to implement it (manually)

!60

Page 61: Maximising the effect of progressive disclosure

!61

minimal information that is always shown

Page 62: Maximising the effect of progressive disclosure

!62

RoboHelp allows drop-down text

Page 63: Maximising the effect of progressive disclosure

!63

inserting and editing hidden information

Page 64: Maximising the effect of progressive disclosure

!64

text is marked as hotspot

Page 65: Maximising the effect of progressive disclosure

!65

the same process can be nested

Page 66: Maximising the effect of progressive disclosure

!66

drop-down content may include images

Page 67: Maximising the effect of progressive disclosure

!67

the end result in a browser: only minimal info is visible

Page 68: Maximising the effect of progressive disclosure

!68

the user can click on triggers to reveal drop-down content

Page 69: Maximising the effect of progressive disclosure

!69

progressive disclosure

Page 70: Maximising the effect of progressive disclosure

!70

this method takes time

Page 71: Maximising the effect of progressive disclosure

progressive disclosurelet's automate the process

!71

* the described automation will be available as a plug-in

for the DITA Open Toolkit

Page 72: Maximising the effect of progressive disclosure

structure + XSLT = magic

!72

Page 73: Maximising the effect of progressive disclosure

XPath : semantic search

!73

Page 74: Maximising the effect of progressive disclosure

XSLT : makeover

!74

Page 75: Maximising the effect of progressive disclosure

!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

Page 76: Maximising the effect of progressive disclosure

!76

DITA task in the editor

Page 77: Maximising the effect of progressive disclosure

!77

standard HTML output

Page 78: Maximising the effect of progressive disclosure

!78

XSL allows automatic

transformation

Page 79: Maximising the effect of progressive disclosure

!79

<shortdesc> is changed into

a tooltip

Page 80: Maximising the effect of progressive disclosure

!80

CSS makes specified elements

initially hidden

Page 81: Maximising the effect of progressive disclosure

!81

JavaScript links triggers to their target content

Page 82: Maximising the effect of progressive disclosure

!82

result of the XSLT

Page 83: Maximising the effect of progressive disclosure

!83

output in a browser

Page 84: Maximising the effect of progressive disclosure

!84

clicking a + symbols opens the <substeps>

Page 85: Maximising the effect of progressive disclosure

!85

other symbols open <info> and <result>

Page 86: Maximising the effect of progressive disclosure

!86

moving mouse over title reveals <shortdesc>

Page 87: Maximising the effect of progressive disclosure

!87

+ symbol top right opens <context>

Page 88: Maximising the effect of progressive disclosure

!88

further learning

Page 89: Maximising the effect of progressive disclosure

Nielsen Norman group

!89

www.nngroup.com

Page 90: Maximising the effect of progressive disclosure

questions ?www.jang.nl

[email protected]

4everJang

blogs.jang.nl

!90