Courtesy of Lynn Langit (tweet)
[] Know your audience[] Action/movement[] Vernacular[] Links[] Simple charts[] Twitter every page[] Font size[] 2 minutes screen cast[] What's in it for me[] Practice 3 times[] Theme/Fonts[] Post slides ASAP[] Caption screen cast[] 3 bullet Max[] No slang[] Retweet comments[] Take pictures[] Silence your phone[] Define terms[] Ask questions[] Tell a story[] No walls of text[] GitHub repos[] Verify references[] Smile[] Don't take questions[] Hallway track[] Avoid haters[] Thank organizers[] Be your emotion
A tutorials
is learning oriented
allows the newcomer to get started
is a lesson
Analogy: teaching a child how to cook
A how-to guides
is goal-oriented
shows how to solve a specific problem
is a series of steps
Analogy: a recipe in cookery book
An explanation
is understanding-oriented
explains
provides background and context
Analogy: an article on culinary social history
A reference guide:
is information-oriented
describes the machinery
is accurate and complete
Analogy: a reference encyclopaedia article