Post History

Source: https://writers.stackexchange.com/a/3751
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/

I am an experienced technical writer specializing in API documentation. In my experience, in order to be successful a technical writer needs enough technical aptitude to (1) understand the users' needs and (2) probe the subject-matter experts (SMEs). If all you're going to do is parrot what the SMEs tell you, you're going to miss important details. SMEs (in any field) have blind spots; they've been living in the depths of their code so long that they can forget that the "obvious" assumptions aren't obvious. They also tend to have a particular model of how users will use their product, which might be more speculative than reality-based. (I'm not criticizing them; they often don't have enough information.) It's the technical writer's job to dig into all that. (Also the tester's, if you have one.)

When I hire technical writers I look for a certain threshold of writing skill but then I look for technical aptitude. I'd rather have a competent writer who understands the technology than a writer who produces excellent prose but needs lots of help to figure out what to write. It's easier to help the competent writer improve writing than it is to help somebody deeply understand the relevant technology.

Original score: 12