Sunday, November 13, 2011

Guidelines for Technical Writing

1) Front end loading - the beginning is most read and most important
2) KISS - Keep it Simple, Stupid (& short) - trim from the start, do not overload.
3) Have empathy - Do not get too technical with readers
4) Goal Orientation - Specific goal
5) Edit, Edit, Edit! - Eliminate unnecessary stuff
6) Be graceful in Ignorance - avoid topics which you are not an expert on
7) Organization - headings, subheadings, listings etc

No comments: