Become a Great Technical Writer even if you are not a great writer
Are you contemplating or beginning a career in technical writing? Have you been asked to create the user guide for your company's software application? Have you been asked to hire and manage a writer?
Where do you begin? How can you get an interview when you have no experience? How do you know if the technical writer on your team is doing a good job or a poor one? Can you find out before you hire the person?
Technical writers (known as technical authors in the United Kingdom) translate and organize complex information into user guides that any person can understand and use with ease. But in the 20 years that I have been in the business, I have often found myself working with writers who do not really know how to write manuals or use the desktop publishing software, and with clients who are not entirely sure what to expect from writers. More often, I have had to clean up a documentation mess left behind by a previous writer. This asymmetry between expectation and output can create technical writers who unknowingly make the same costly mistakes year after year, and companies who regard technical writers as a high-cost, low-value drain on the company's bottom line.
This site, whether you are a manager or a technical writer, will get you all working on the same page. If you are a writer, you will see that technical writing requires skills other than the ability to write. In fact, it is possible to write great user guides even if you are not a great writer. You don't need to spell perfectly (I don't), and you don't need to know the difference between a dangling participle and a dangling gerund. But although you don't have to be a great writer, you will probably be happier in the job if you like writing and are a competent writer. If you find it difficult to organize your thoughts and put them down in writing, you might find the job boring, unpleasant, and unrewarding.
In fact, writing is only a fraction of what you will do as a technical writer. This site, therefore, does not show you how to become a great writer—many other sites exist to help you with your grammar and style—but it does provide you with information, skills, tips, and techniques that can help you become a great technical writer.
Notes For Managers If you are a manager, this site shows you what you can expect from the technical writers on your team. Although this site speaks mainly to the writer, you will easily be able to develop from the information provided your own expectations and requirements for your writers. This site will also help you distinguish between good and bad technical writing and it will tell you what to look for when hiring a writer. In particular, you should read the first three articles below.