Technical writer

From Wikipedia, the free encyclopedia

Jump to: navigation, search

Contents

A technical writer is a professional writer who designs, writes, creates, maintains, and updates technical documentation—including online help, user guides, white papers, design specifications, system manuals, and other documents. Engineers, scientists, and other professionals may also produce technical writing, sometimes handing their work to a professional technical writer for editing and formatting. A technical writer produces technical documentation for technical, business, and consumer audiences.

[edit] Skill set

Beyond solid research, language, and writing skills, a technical writer's skill set may include:

Technical writing may be on any subject that requires explanation to a particular audience. A technical writer usually is not a Subject Matter Expert (SME), but possesses and applies expertise to interview SMEs and conduct research necessary to produce accurate, comprehensive documents. Companies, governments, and other institutions typically hire technical writers not for expertise in a particular subject, but for expertise in technical writing, i.e., their ability to gather information, analyze subject and audience, and produce clear documentation.

A good technical writer creates documentation that is accurate, complete, unambiguous, and as concise as possible. Technical writers create documentation in many forms: printed, web-based or other electronic documentation, training materials, and industrial film scripts.

[edit] Qualifications

Technical writers work under many job titles, including Technical Communicator, Information Developer, Data Development Engineer, and Technical Documentation Specialist'. In the United Kingdom and some other countries, a technical writer is often called a technical author or knowledge author.

Technical writers normally possess a mix of technical and language abilities. They may have a degree or certification in technical communications. Many technical writers switch from another technical field such as engineering or science, often after taking classes in technical communications.

A good technical writer has the ability to create, assimilate, and convey technical material in a concise and effective manner. A technical writer may specialize in a particular area. For example, API writers mostly work on API documents, while other technical writers specialize in e-commerce, manufacturing, scientific, or medical material.

[edit] Methodology

When creating a document, a technical writer gathers information by studying existing material and interviewing subject matter experts (SMEs). The technical writer also studies the audience to learn their needs and technical level.

Well-formed technical documents follow common publishing guidelines. Technical documentation comes in all styles and formats, depending on the medium. Printed documentation has different standards from online documentation. Usually, technical writers follow formatting conventions described in a standard style guide. In the US, most technical writers use the Chicago Manual of Style (CMS). Many companies have their own corporate style guides, typically extensions of the CMS to cover specific corporate issues. The Microsoft Manual of Style for Technical Publications typifies these.

Engineering projects, particularly defense or aerospace related projects, often follow national and international documentation standards—such as ATA100 for civil aircraft, or S1000D for defense platforms.

[edit] Environment

Technical writers often work as part of a writing or project development team. Typically, the writer finishes a draft and passes it to one or more SMEs who conduct a technical edit to review it for accuracy and completeness. In some cases the writer or others test the document on audience members.

On a project team, a technical writer develops the overall project documentation, as other members of the team develop other areas of the project. For example, as engineers design and integrate a system, the technical writer generates the manuals that go with the system.

[edit] Career growth

A technical writer has no standard career level of advancement, but technical writers can move up into management of other writers. A writer may grow into a senior technical writer position, handling complex projects or a small team of writers and editors. In even larger groups, a documentation manager might handle multiple projects and teams.

Technical writers might also gain expertise in a specific technical domain and branch out into related forms. Examples are writers who work in the fields of software quality analysis or business analysis. Once a technical writer becomes a subject matter expert in any field, he or she may decide to stay as an analyst within that field. However, this activity is then no longer technical writing per se, but some other kind of analysis which makes use of technical writing as a sub-skill.

Senior writers in some software documentation departments are increasingly termed Individual Contributor or ICs. See also API writer. In API/software documentation, IC's typically work with a team of developers or testers working across many physical locations. In such software development in "software research organizations," an IC plays an important role in the delivery of API/Software documentation.

[edit] See also

[edit] External links

 This article's external links may not follow Wikipedia's content policies or guidelines. Please improve this article by removing excessive or inappropriate external links.
Retrieved from "http://en.wikipedia.org/wiki/Technical_writer"
Personal tools