Successfully reported this slideshow.
Your SlideShare is downloading. ×

How to write a how to

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.

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.

More Related Content

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

×