Technical writing

Last updated

Technical writing is the writing of technical content, particularly relating to industrial and other applied sciences, with an emphasis on occupational contexts. [1] The range of audiences for technical writing varies widely. In some cases, it is directed to people with specialized knowledge, such as experts or technicians. [2] In other situations, technical writers help convey complex scientific or niche subjects to end users who need a basic understanding of a concept rather than a full explanation of a subject. [3] Technical writing is the largest part of technical communication. [4]

Contents

Examples of fields requiring technical writing include computer hardware and software, architecture, engineering, chemistry, aeronautics, robotics, finance, medical, consumer electronics, biotechnology, and forestry.

Overview

Technical writing is performed by a technical writer (or technical author) and is the process of writing and sharing technical information in a professional setting. [5] : 4  A technical writer's primary task is to communicate technical information to another person or party in the clearest and most effective manner possible. [5] : 4  [6] The information that technical writers communicate is often complex, so strong writing and communication skills are essential. Technical writers not only convey information through text, but they must be proficient with computers as well. Technical writers use a wide range of programs to create and edit illustrations, diagramming programs to create visual aids, and document processors to design, create, and format documents. [7]

While technical writing is commonly associated with instructions and user manuals, the terms technical writing and technical documentation can cover a wider range of genres and formats. memos, reports, business proposals, datasheets, product descriptions and specifications, and white papers are but a few examples of writing that can be considered technical documentation. [8] And for highly technical jobs (e.g., engineering and other applied sciences), aspects of résumés and job applications can also be considered technical writing.

Technical writing is not always handled by dedicated technical writers. For example, engineers often need to write directly about their own work. On the business side, marketing materials or press releases are usually written by people in those fields, although a technical writer or other technical person may need to have input on any technical subject matter involved.

History

While technical writing has only been recognized as a profession since World War II, [9] : 2  [10] its roots can be traced to classical antiquity. [11] : 233  Critics cite the works of writers like Aristotle as the earliest forms of technical writing. [11] : 234  Geoffrey Chaucer's work, A Treatise on the Astrolabe , is an early example of a technical document. [12] The earliest examples of technical writing date back to the Old English period. [13]

With the invention of the mechanical printing press, the onset of the Renaissance and the rise of the Age of Reason, documenting findings became a necessity. Inventors and scientists like Isaac Newton and Leonardo da Vinci prepared documents that chronicled their inventions and findings. [9] : 1  While never called technical documents during their period of publication, these documents played a crucial role in developing modern forms of technical communication and writing. [9]

The field of technical communication grew during the Industrial Revolution. [14] : 3  There was a growing need to provide people with instructions for using the increasingly complex machines that were being invented. [14] : 8  However, unlike the past, where skills were handed down through oral traditions, no one besides the inventors knew how to use these new devices. Writing thus became the fastest and most effective way to disseminate information, and writers who could document these devices were desired. [14]

During the 20th century, the need for technical writing skyrocketed, and the profession became officially recognized. The events of World War I and World War II led to advances in medicine, military hardware, computer technology, and aerospace technologies. [9] : 2  This rapid growth, coupled with the urgency of war, created an immediate need for well-designed documentation to support the use of these technologies. Technical writing was in high demand during this time, and "technical writer" became an official job title during World War II. [9] : 1 

Following World War II, technological advances led to an increase in consumer goods and standards of living. [9] : 3  During the post-war boom, public services like libraries and universities, as well as transport systems like buses and highways, saw substantial growth. The need for writers to chronicle these processes increased. [9] : 1  It was also during this period that large business and universities started using computers. Notably, in 1949, Joseph D. Chapline authored the first computational technical document, an instruction manual for the BINAC computer. [15]

The invention of the transistor in 1947 allowed computers to be produced more cheaply and within the purchasing range of individuals and small businesses. [9] : 3  As the market for these "personal computers" grew, so did the need for writers who could explain and provide user documentation for these devices. [9] : 3  The profession of technical writing saw further expansion during the 1970s and 1980s as consumer electronics found their way into the homes of more and more people. [9]

In recent years, the prominence of computers in society has led to many advances in the field of digital communications, leading to changes in the tools technical writers use. [9] : 3  Hypertext, word processors, graphics editing programs, and page laying software have made the creation of technical documents faster and easier, and technical writers of today must be proficient in these programs. [5] : 8–9 

Technical documents

Technical writing covers many genres and writing styles, depending on the information and audience. [5] : 84–114  Technical documents are not solely produced by technical writers. Almost anyone who works in a professional setting produces technical documents of some variety. Some examples of technical documentation include:

Tools

The following tools are used by technical writers to author and present documents:

List of associations

Related Research Articles

<span class="mw-page-title-main">Graphic design</span> Interdisciplinary branch of design and of the fine arts

Graphic design is a profession, academic discipline and applied art whose activity consists in projecting visual communications intended to transmit specific messages to social groups, with specific objectives. Graphic design is an interdisciplinary branch of design and of the fine arts. Its practice involves creativity, innovation and lateral thinking using manual or digital tools, where it is usual to use text and graphics to communicate visually.

Software documentation is written text or illustration that accompanies computer software or is embedded in the source code. The documentation either explains how the software operates or how to use it, and may mean different things to people in different roles.

<span class="mw-page-title-main">Intranet</span> Network of private resources in an organization

An intranet is a computer network for sharing information, easier communication, collaboration tools, operational systems, and other computing services within an organization, usually to the exclusion of access by outsiders. The term is used in contrast to public networks, such as the Internet, but uses the same technology based on the Internet protocol suite.

Collaborative software or groupware is application software designed to help people working on a common task to attain their goals. One of the earliest definitions of groupware is "intentional group processes plus software to support them."

<span class="mw-page-title-main">Adobe FrameMaker</span> Document processor for the production and manipulation of large structured documents

Adobe FrameMaker is a document processor designed for writing and editing large or complex documents, including structured documents. It was originally developed by Frame Technology Corporation, which was bought by Adobe.

<span class="mw-page-title-main">Tutorial</span> Type of educational intervention

A tutorial, in education, is a method of transferring knowledge and may be used as a part of a learning process. More interactive and specific than a book or a lecture, a tutorial seeks to teach by example and supply the information to complete a certain task.

Documentation is any communicable material that is used to describe, explain or instruct regarding some attributes of an object, system or procedure, such as its parts, assembly, installation, maintenance, and use. As a form of knowledge management and knowledge organization, documentation can be provided on paper, online, or on digital or analog media, such as audio tape or CDs. Examples are user guides, white papers, online help, and quick-reference guides. Paper or hard-copy documentation has become less common. Documentation is often distributed via websites, software products, and other online applications.

Social software, also known as social apps or social platform includes communications and interactive tools that are often based on the Internet. Communication tools typically handle capturing, storing and presenting communication, usually written but increasingly including audio and video as well. Interactive tools handle mediated interactions between a pair or group of users. They focus on establishing and maintaining a connection among users, facilitating the mechanics of conversation and talk. Social software generally refers to software that makes collaborative behaviour, the organisation and moulding of communities, self-expression, social interaction and feedback possible for individuals. Another element of the existing definition of social software is that it allows for the structured mediation of opinion between people, in a centralized or self-regulating manner. The most improved area for social software is that Web 2.0 applications can all promote co-operation between people and the creation of online communities more than ever before. The opportunities offered by social software are instant connections and opportunities to learn.An additional defining feature of social software is that apart from interaction and collaboration, it aggregates the collective behaviour of its users, allowing not only crowds to learn from an individual but individuals to learn from the crowds as well. Hence, the interactions enabled by social software can be one-to-one, one-to-many, or many-to-many.

A technical writer is a professional information communicator whose task is to transfer information between two or more parties, through any medium that best facilitates the transfer and comprehension of the information. Technical writers research and create information through a variety of delivery media. Example types of information include online help, manuals, white papers, design specifications, project plans, and software test plans. With the rise of e-learning, technical writers are increasingly becoming involved with creating online training material.

Technical communication is communication of technical subject matter such as engineering, science, or technology content. The largest part of it tends to be technical writing, though importantly it often requires aspects of visual communication. Technical communication also encompasses oral delivery modes such as presentations involving technical material. When technical communication occurs in workplace settings, it's considered a major branch of professional communication. In research or R&D contexts, it can overlap with scientific writing.

Audience analysis is a task that is often performed by technical writers in a project's early stages. It consists of assessing the audience to make sure the information provided to them is at the appropriate level. The audience is often referred to as the end-user, and all communications need to be targeted towards the defined audience. Defining an audience requires the consideration of many factors, such as age, culture and knowledge of the subject. After considering all the known factors, a profile of the intended audience can be created, allowing writers to write in a manner that is understood by the intended audience.

A medical writer, also referred to as medical communicator, is a person who applies the principles of clinical research in developing clinical trial documents that effectively and clearly describe research results, product use, and other medical information. The medical writer develops any of the five modules of the Common Technical Document. The medical writers also ensure that their documents comply with regulatory, journal, or other guidelines in terms of content, format, and structure.

Software project management is the process of planning and leading software projects. It is a sub-discipline of project management in which software projects are planned, implemented, monitored and controlled.

User experience design defines the experience a user would go through when interacting with a company, its services, and its products. User experience design is a user centered design approach because it considers the user's experience when using a product or platform. Research, data analysis, and test results drive design decisions in UX design rather than aesthetic preferences and opinions. Unlike user interface design, which focuses solely on the design of a computer interface, UX design encompasses all aspects of a user's perceived experience with a product or website, such as its usability, usefulness, desirability, brand perception, and overall performance. UX design is also an element of the customer experience (CX), and encompasses all aspects and stages of a customer's experience and interaction with a company.

Technical translation is a type of specialized translation involving the translation of documents produced by technical writers, or more specifically, texts which relate to technological subject areas or texts which deal with the practical application of scientific and technological information. While the presence of specialized terminology is a feature of technical texts, specialized terminology alone is not sufficient for classifying a text as "technical" since numerous disciplines and subjects which are not "technical" possess what can be regarded as specialized terminology. Technical translation covers the translation of many kinds of specialized texts and requires a high level of subject knowledge and mastery of the relevant terminology and writing conventions.

An API writer is a technical writer who writes documents that describe an application programming interface (API). The primary audience includes programmers, developers, system architects, and system designers.

<span class="mw-page-title-main">Text annotation</span> Adding a note or gloss to a text

Text annotation is the practice and the result of adding a note or gloss to a text, which may include highlights or underlining, comments, footnotes, tags, and links. Text annotations can include notes written for a reader's private purposes, as well as shared annotations written for the purposes of collaborative writing and editing, commentary, or social reading and sharing. In some fields, text annotation is comparable to metadata insofar as it is added post hoc and provides information about a text without fundamentally altering that original text. Text annotations are sometimes referred to as marginalia, though some reserve this term specifically for hand-written notes made in the margins of books or manuscripts. Annotations have been found to be useful and help to develop knowledge of English literature.

<span class="mw-page-title-main">Software categories</span> Groups of software

Software categories are groups of software. They allow software to be understood in terms of those categories, instead of the particularities of each package. Different classification schemes consider different aspects of software.

Proposal software also known as proposal management software, proposal writing software, or proposal automation software is a computer program designed to help users develop proposals, presentations, and responses to RFPs. Proposal management software is becoming increasingly popular in companies that manage frequent and extensive proposal writing projects. Such software allows businesses to automate more routine tasks while easily tracking multiple versions.

Distributed Collaboration is a way of collaboration wherein participants, regardless of their location, work together to reach a certain goal. This usually entails use of increasingly popular cyberinfrastructure, such as emails, instant messaging and document sharing platforms to reduce the limitations of the users trying to work together from remote locations by overcoming physical barriers of geolocation and also to some extent, depending on the application used, the effects of working together in person. For example, a caller software that can be used to bring all collaborators into a single call-in for easier dissemination of ideas.

References

  1. ↑ "What is Technical Writing? - Tech Writer Today".
  2. ↑ Hamlin, Annemarie; Rubio, Chris; Desilva, Michele (2015). "Audience Analysis".
  3. ↑ Marshall, Carrie (2018). Technical Writing For Business People (1st ed.). Swindon UK. p. 1.
  4. ↑ "Technical Communications - What is it? - Tech Writer Today".
  5. 1 2 3 4 5 6 7 8 9 Mike Markel (2012). Technical Communication 10th Edition. Bedford/St. Martins.
  6. ↑ "Technical Writers : Occupational Outlook Handbook: : U.S. Bureau of Labor Statistics". www.bls.gov. Retrieved 2024-02-14.
  7. ↑ Johnson, Tom (December 19, 2011). "What Tools Do Technical Writers Use". I'd Rather Be Writing. Retrieved May 4, 2014.
  8. ↑ Perelman, Leslie C.; Barrett, Edward; Paradis James. "Document Types". The Mayfield Handbook of Technical & Scientific Writing. Retrieved May 4, 2014.
  9. 1 2 3 4 5 6 7 8 9 10 11 O'Hara, Fredrick M. Jr. "A Brief History of Technical Communication" (PDF). Montana State University Billings. Retrieved April 22, 2014.
  10. ↑ Alamargot, Denis; Terrier, Patrice; Cellier, Jean-Marie, eds. (2007-10-01). Written Documents in the Workplace. doi:10.1163/9789004253254. ISBN   9780080474878.
  11. 1 2 Doody, Aude; Follinger, Sabine; Taub, Liba (February 8, 2012). "Structures and Strategies in Ancient Greek and Roman Technical Writing: An Introduction" (PDF). Studies in History and Philosophy of Science. University Of Cambridge. 43 (2): 233–236. Bibcode:2012SHPSA..43..233D. doi:10.1016/j.shpsa.2011.12.021. Archived from the original (PDF) on August 3, 2012. Retrieved April 22, 2014.
  12. ↑ "The Way to the Stars: Build Your Own Astrolabe". Saint John's College. Retrieved April 22, 2014.
  13. ↑ Hagge, John (July 1990). "The First Technical Writer in English: A Challenge to the Hegemony of Chaucer". Journal of Technical Writing and Communication. 20 (3): 269–289. doi:10.2190/vwcw-xkmv-949f-vlf7. ISSN   0047-2816. S2CID   170879476.
  14. 1 2 3 Crabbe, Stephen (2012). "Constructing a Contextual History of English Language Technical Writing" (PDF). University of Portsmouth. Archived from the original (PDF) on May 12, 2014. Retrieved April 30, 2014.
  15. ↑ "History of Technical Writing". Proedit. 14 September 2012. Retrieved May 9, 2014.
  16. ↑ "Dictionary and Thesaurus". Merriam-Webster. Retrieved 2016-01-22.
  17. 1 2 3 4 5 6 7 Tebeaux, Elizabeth; Dragga, Sam (2010). The Essentials of Technical Communication. Oxford University Press.
  18. ↑ Perelman, Leslie C., Barrett, Edward, and Paradis James. "Press jaylan peregrino". The Mayfield grave naba Handbook of Technical & Scientific Writing. Retrieved May 4, 2014.
  19. ↑ Perelman, Leslie C., Barrett, Edward, and Paradis James. "Specifications." The Mayfield Handbook of Technical & Scientific Writing. Retrieved May 4, 2014.
  20. 1 2 Anderson, Paul V. (2007). Technical Communication [A Reader-Centered Approach] 6th Edition. Thompson Wadsworth.
  21. ↑ Johnson, Tom "What Tools Do Technical Writers Use". I'd Rather Be Writing. December 19, 2011. Retrieved May 4, 2014.
  22. ↑ "What is LyX". LyX. Retrieved May 9, 2014.
  23. ↑ Hewitt, John (January 18, 2005). "How Technical Writers use Microsoft Visio". Poe War. Archived from the original on May 12, 2014. Retrieved May 9, 2014.
  24. ↑ Brierley, Sean (2002). Screen Captures 102 (PDF). STC Carolina (Report). pp. 5–8. Retrieved May 9, 2014.
  25. ↑ Johnson, Tom (December 19, 2011). "What Tools Do Technical Writers Use". I'd Rather Be Writing. Retrieved May 4, 2014.
This page is based on this Wikipedia article
Text is available under the CC BY-SA 4.0 license; additional terms may apply.
Images, videos and audio are available under their respective licenses.