how to write a how to
Post on 25-Jan-2017
480 Views
Preview:
TRANSCRIPT
erin malone @emalone
How ToHow to write a How-To
erin malone @emalone
My book
By Erin Malone and Christian Crumlish http://www.oreilly.com/pub/get/DWS
erin malone @emalone
OverviewOverview Step by Step Process Writing Exercise Share
erin malone @emalone
How to’s?Tutorials How-tos Instructional Design Recipes Walkthroughs Interface copy
Step-by-steps Tours Patterns Anti-Patterns Onboarding Help
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
erin malone @emalone
1.Who is it for?
erin malone @emalone
2. Give overview
erin malone @emalone
3. What tools?
erin malone @emalone
4. List out the steps
Permanent link to this comic: http://www.dearfuture.com/190/ (this image has been modified to fit horizontally)
erin malone @emalone
5. Drill down to sub-steps
erin malone @emalone
5. & flesh out the smaller tasks
erin malone @emalone
6. Show alternative steps
erin malone @emalone
7. Tips
erin malone @emalone
8. Pictures worth 1000 words
erin malone @emalone
9. Summarize and Reinforce
erin malone @emalone
10. Related & more
erin malone @emalone
Summary1. 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
erin malone @emalone
Let’s Writeexercise
Permanent link to this comic: http://xkcd.com/1029/
erin malone @emalone
Group Exercise
How to boil an egg
erin malone @emalone
Group Exercise
How to create a sitemap
erin malone @emalone
Exercise1. Select something you know well 2. Write / Act out 3. Swap with partner 4. Critique / Ask questions 5. Iterate
Share
erin malone @emalone
Thanksemail: erin@tangible-ux.com (or) erin@emdezine.com twitter: @emalone linkedin: www.linkedin.com/in/erinkmalone
top related