Comments on: How to Write a How-To http://diyubook.com/2011/01/how-to-write-a-how-to/ Edupunks, Edupreneurs, and the coming transformation of higher education Thu, 18 Jul 2013 18:44:23 +0000 hourly 1 http://wordpress.org/?v=3.0.1 By: Kasal Payo http://diyubook.com/2011/01/how-to-write-a-how-to/comment-page-1/#comment-4942 Kasal Payo Sun, 05 Jun 2011 22:18:46 +0000 http://diyubook.com/?p=393#comment-4942 Pick up your sword and fight!! Pick up your sword and fight!!

]]> By: Janet Swisher http://diyubook.com/2011/01/how-to-write-a-how-to/comment-page-1/#comment-4099 Janet Swisher Mon, 31 Jan 2011 21:19:49 +0000 http://diyubook.com/?p=393#comment-4099 I agree with Josh's suggestions. Steps should be just one action each, and should describe the outcome or state when you complete the step correctly (unless it's trivial, obvious, or already covered by the action description). Keep all steps together, and don't interleave them with conceptual explanations. Put concepts before, after, or elsewhere. Put warnings and cautions <em>before</em> the step they apply to. I agree with Josh’s suggestions.

Steps should be just one action each, and should describe the outcome or state when you complete the step correctly (unless it’s trivial, obvious, or already covered by the action description).

Keep all steps together, and don’t interleave them with conceptual explanations. Put concepts before, after, or elsewhere.

Put warnings and cautions before the step they apply to.

]]> By: Josh Baron http://diyubook.com/2011/01/how-to-write-a-how-to/comment-page-1/#comment-4031 Josh Baron Wed, 26 Jan 2011 23:32:26 +0000 http://diyubook.com/?p=393#comment-4031 Maybe tips/tricks or pitfalls to avoid? I'm thinking of assembling things like a bike or kids toy...the people will often point on out blogs, etc. where the common confusion points are or common mistakes to avoid. Might also want to suggest desired outcomes/goals...something like, you'll know that you've successfully adopted an open textbook when your students tell other instructors they should be using open textbooks also... Maybe tips/tricks or pitfalls to avoid? I’m thinking of assembling things like a bike or kids toy…the people will often point on out blogs, etc. where the common confusion points are or common mistakes to avoid.

Might also want to suggest desired outcomes/goals…something like, you’ll know that you’ve successfully adopted an open textbook when your students tell other instructors they should be using open textbooks also…

]]>