Created by Tom Johnson / @tomjohnson
idratherbewriting.com
Write the Docs Portland 2017
May 15, 2017
Next slide | Space bar |
Full screen | F |
Index | Esc |
Note: Slides can also move down, such as when I'm exploring a design principle in depth.
If so, the arrow on the lower-right indicates the vertical direction. Test it out now.
How do you increase the user's ability to find answers in docs?
"Hierarchical organization is the simplest structure for visualizing and understanding complexity."
— Universal Principles of Design
"A strategy for managing information complexity in which only necessary or requested information is displayed at any given time."
— Universal Principles of Design"A state of mental focus so intense that awareness of the 'real' world is lost, generally resulting a feeling of joy and satisfaction."
— Universal Principles of Design
— Mark Baker
- If you tell me I can do something, link to how to do that something.
- If you tell me I can use something, link to a description of that something.
- If you mention a concept or an idea, link to a description of that concept or idea.
"Traces of use or wear that indicate preferred methods of interaction with an object or environment." — Universal Principles of Design
"A method of managing system complexity that involves dividing large systems into multiple, smaller self-contained systems."
— Universal Principles of Design
You can just read the sections about the tasks you want to do.— John Carroll, The Nurnberg Funnel
"The process of using spatial and environmental information to navigate to a destination."
— Universal Principles of Design
With your own documentation in mind, how are you incorporating some of the following design principles?
Tom Johnson
— idratherbewriting.com
— @tomjohnson
— [email protected]