Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
erin malone
@emalone
HowToHowtowriteaHow-To
erin malone
@emalone
Mybook
By Erin Malone and Christian Crumlish
http://www.oreilly.com/pub/get/DWS
erin malone
@emalone
Overview
Overview
Step by Step Process
Writing Exercise
Share
erin malone
@emalone
Howto’s?
Tutorials
How-tos
Instructional Design
Recipes
Walkthroughs
Interface copy
Step-by-steps
Tou...
erin malone
@emalone
Overview
Tips:
• Write about something you know well.
• Make the thing yourself.

Do the process your...
erin malone
@emalone
1.Whoisitfor?
erin malone
@emalone
2.Giveoverview
erin malone
@emalone
3.Whattools?
erin malone
@emalone
4.Listoutthesteps
Permanent link to this comic: http://www.dearfuture.com/190/
(this image has been m...
erin malone
@emalone
5.Drilldowntosub-steps
erin malone
@emalone
5.&fleshoutthesmallertasks
erin malone
@emalone
6.Showalternativesteps
erin malone
@emalone
7.Tips
erin malone
@emalone
8.Picturesworth1000words
erin malone
@emalone
9.SummarizeandReinforce
erin malone
@emalone
10.Related

&more
erin malone
@emalone
Summary
1. Define audience
2. Give overview
3. List tools
4. Detail steps
5. and substeps
6. and any ...
erin malone
@emalone
Let’sWriteexercise
Permanent link to this comic: http://xkcd.com/1029/
erin malone
@emalone
GroupExercise
How to boil an egg
erin malone
@emalone
Group Exercise
How to create a sitemap
erin malone
@emalone
Exercise
1. Select something you know well
2. Write / Act out
3. Swap with partner
4. Critique / Ask ...
erin malone
@emalone
Thanks
email: erin@tangible-ux.com (or) erin@emdezine.com
twitter: @emalone
linkedin: www.linkedin.co...
You’ve finished this document.
Download and read it offline.
Upcoming SlideShare
Юрий Ветров — Внедрение UX-стратегии
Next
Upcoming SlideShare
Юрий Ветров — Внедрение UX-стратегии
Next
Download to read offline and view in fullscreen.

Share

How to write a how to

Download to read offline

Instructions for UX Designers for How to write How-To's and Help. Originally presented as part of the Boxes and Arrows Design Writing Summit in early 2015.

Related Books

Free with a 30 day trial from Scribd

See all

Related Audiobooks

Free with a 30 day trial from Scribd

See all

How to write a how to

  1. 1. erin malone @emalone HowToHowtowriteaHow-To
  2. 2. erin malone @emalone Mybook By Erin Malone and Christian Crumlish http://www.oreilly.com/pub/get/DWS
  3. 3. erin malone @emalone Overview Overview Step by Step Process Writing Exercise Share
  4. 4. erin malone @emalone Howto’s? Tutorials How-tos Instructional Design Recipes Walkthroughs Interface copy Step-by-steps Tours Patterns Anti-Patterns Onboarding Help
  5. 5. erin malone @emalone Overview Tips: • Write about something you know well. • Make the thing yourself.
 Do the process yourself and document as you go. • Use the process to better solidify a process for yourself. 
 You know it well if you can explain it to someone else clearly. • Show, do, show, do A How-to is essentially a recipe - for whatever - for cooking, for writing, for teaching, for coding, for making
  6. 6. erin malone @emalone 1.Whoisitfor?
  7. 7. erin malone @emalone 2.Giveoverview
  8. 8. erin malone @emalone 3.Whattools?
  9. 9. erin malone @emalone 4.Listoutthesteps Permanent link to this comic: http://www.dearfuture.com/190/ (this image has been modified to fit horizontally)
  10. 10. erin malone @emalone 5.Drilldowntosub-steps
  11. 11. erin malone @emalone 5.&fleshoutthesmallertasks
  12. 12. erin malone @emalone 6.Showalternativesteps
  13. 13. erin malone @emalone 7.Tips
  14. 14. erin malone @emalone 8.Picturesworth1000words
  15. 15. erin malone @emalone 9.SummarizeandReinforce
  16. 16. erin malone @emalone 10.Related
 &more
  17. 17. erin malone @emalone Summary 1. Define audience 2. Give overview 3. List tools 4. Detail steps 5. and substeps 6. and any alternative steps 7. Tips 8. Pictures 9. Final Summary 10.References How to cook pasta - by Christina Wodtke
  18. 18. erin malone @emalone Let’sWriteexercise Permanent link to this comic: http://xkcd.com/1029/
  19. 19. erin malone @emalone GroupExercise How to boil an egg
  20. 20. erin malone @emalone Group Exercise How to create a sitemap
  21. 21. erin malone @emalone Exercise 1. Select something you know well 2. Write / Act out 3. Swap with partner 4. Critique / Ask questions 5. Iterate
 
 Share
  22. 22. erin malone @emalone Thanks email: erin@tangible-ux.com (or) erin@emdezine.com twitter: @emalone linkedin: www.linkedin.com/in/erinkmalone
  • BrennerC

    Nov. 26, 2020

Instructions for UX Designers for How to write How-To's and Help. Originally presented as part of the Boxes and Arrows Design Writing Summit in early 2015.

Views

Total views

13,601

On Slideshare

0

From embeds

0

Number of embeds

8,486

Actions

Downloads

6

Shares

0

Comments

0

Likes

1

×