introduction presenter: matthew howse date: 9/23/08 article: "adding life to your...
DESCRIPTION
N- list N- list, no more that 15 main points keep it brief Can be links off the 15 main points K.I.S.S. keep it simple stupid. “The Least You Need to Know” ListsTRANSCRIPT
![Page 1: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/1.jpg)
IntroductionIntroduction
Presenter: Matthew HowsePresenter: Matthew HowseDate: 9/23/08Date: 9/23/08
Article: Article: "Adding Life to Your Documentation""Adding Life to Your Documentation" Author: Whitney Beth PotsusAuthor: Whitney Beth Potsus
![Page 2: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/2.jpg)
OverviewOverview
Ever get caught in a writers blockEver get caught in a writers block
Doing the same thing day in and day outDoing the same thing day in and day out
How to get past writers block and keep the How to get past writers block and keep the readers attention.readers attention.
![Page 3: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/3.jpg)
N- listN- list
N- list, no more that 15 main points keep it N- list, no more that 15 main points keep it brief brief
Can be links off the 15 main pointsCan be links off the 15 main pointsK.I.S.S. keep it simple stupid. K.I.S.S. keep it simple stupid. ““The Least You Need to Know” ListsThe Least You Need to Know” Lists
![Page 4: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/4.jpg)
Use to-do Lists, Recipes, Use to-do Lists, Recipes, Checklists.Checklists.
Described as shopping list documentationDescribed as shopping list documentation
Having everything you need before you follow a procedure. Having everything you need before you follow a procedure. Checklist what to do before the next step.Checklist what to do before the next step.Great for assemblies, installation, and procedural directions.Great for assemblies, installation, and procedural directions.
![Page 5: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/5.jpg)
““The least you need The least you need to know” lists.to know” lists.
Giving you the bare minimum of the topicGiving you the bare minimum of the topic
Not very in-depth Not very in-depth Just good enough for a basic understandingJust good enough for a basic understanding
![Page 6: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/6.jpg)
Telling the users what they’re supposed to do.
Very technical, usually wanting the user to Very technical, usually wanting the user to do something. do something.
Best/Common Practices Best/Common Practices Well written can be very goodWell written can be very goodPoorly written can result in 9 support calls per monthPoorly written can result in 9 support calls per month
![Page 7: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/7.jpg)
GraphicsGraphics
Charts, Graphs, tables, and pictures. Charts, Graphs, tables, and pictures.
Good for comparing objects Good for comparing objects Good to grab the reader, more likely to read the articleGood to grab the reader, more likely to read the articleMaking it quick and easy Making it quick and easy
![Page 8: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/8.jpg)
Quizes and other Quizes and other self-testsself-tests
Self explanatory way of explaining getting Self explanatory way of explaining getting you’re point across.you’re point across.
Easy/hardEasy/hardLong/shortLong/shortFun/serrousFun/serrousUseful in training classesUseful in training classes
![Page 9: Introduction Presenter: Matthew Howse Date: 9/23/08 Article: "Adding Life to Your Documentation" "Adding Life to Your Documentation""Adding Life to Your](https://reader036.vdocument.in/reader036/viewer/2022062600/5a4d1b4a7f8b9ab0599a50b9/html5/thumbnails/9.jpg)
ConclusionConclusionMain pointsMain points
“What matters is that they read and felt that they walked away with enough knowledge to be immediately productive.”
Catching the readers attention and holding it.
Effective and fast ways to get your point across.
??Questions????Questions??