Being able to communicate on many different levels, with any kind of colleague, is a crtical component of the technical writer’s skill set. Knowledge of subject, obtained on the fly from any source almost all at once, still requires help for the writer to outline, sort and organize this information and knowledge.
Interviews with people on vastly different organizational levels is not always as easy as it appears. Sometimes…full text or downoad to print.
Asking good questions sounds easy. Moreover, when preceded by good lstening, it is. The most competent technical writer has planned a way of obtaining information. It’s the “Invisible Outline.”
The Invisble Outline constitutes the interviewer’s plan of action. Outline the subject, drill down and outline the separate segments of the subject, and then go interview a “Subject Matter Expert.” Am I really saying “Know what you’re writing about before you do an interview?” Well, yes!
The outline is the “Big Picture.” It’s why I’m a writer. See the whole text, or download.
Back when Quark was an actual product, this was used for an SOP for a small manufacturing company. Without a budget this was cobbled together for a disagreeable group to forge a new law: “If it’s not in the book, we ain’t doin’ it”. To view…