Confessions of a Technical Writer
-
Upload
lana-brindley -
Category
Technology
-
view
853 -
download
5
description
Transcript of Confessions of a Technical Writer
Confessions of a technical writer
9.Nobody notices
what I do
Until I fail to do it
8.A game of scrabble takes 4 days, 7 dictionaries, and a duel to the death.
7.I hate help desk
(But they love me)
6.I don t read manuals’
UsersUsers
ContributorsContributors
DevelopersDevelopers
5.Working with developers is hard
4.I like waterfalls
Information Information Plan Plan (10%)(10%)
Content Content Specification Specification
(20%)(20%)
WritingWriting(50%)(50%)
TranslationTranslation&&
ProductionProduction(19%)(19%)
ReviewReview(1%)(1%)
`̀
ReleaseRelease
5 Phase Model by JoAnn Hackos5 Phase Model by JoAnn Hackos
3.Sometimes, things go
BANG!
2.
I m special
’
But I m not ’
THAT special
GetGetorganisedorganised
ChooseChooseyouryourvoicevoice
Say what you meanSay what you mean
Use short sentencesUse short sentences
Try not to be...
A pretentious jerkA pretentious jerk
A word aboutA word about
passive voicepassive voice
(and cats)(and cats)
Cut out the cruftCut out the cruft
Read what you writeRead what you write
1.I will not stab you
Today.