Technical Writing in the Digital Age: Difference between revisions

From LitWiki
m (Protected "Technical Writing in the Digital Age": Protected for evaluation. ([Edit=Allow only administrators] (expires 13:42, 9 December 2023 (UTC)) [Move=Allow only administrators] (expires 13:42, 9 December 2023 (UTC))))
 
(320 intermediate revisions by 24 users not shown)
Line 1: Line 1:
'''Technical Writing in the Digital Age''' represents the dynamic and evolving discipline of creating written materials that convey complex information, instructions, and technical concepts in the context of contemporary digital technologies. Its purview encompasses the creation, dissemination, and management of technical documents and content within an expansive digital landscape.  
[[File:Digital writing.jpg|thumb|Book cover for "Digital Writing" by Dan Lawrence]]
'''Technical Writing in the Digital Age''' represents the dynamic and evolving discipline of creating written, visual, and interactive materials that convey complex information, instructions, and technical concepts in the context of contemporary digital technologies.  


Major considerations revolve around adapting traditional principles of rhetoric to digital platforms, ensuring effective communication in an era defined by rapid technological advancements. Key factors include integrating multimedia elements, user-centered design principles, and ethical considerations like accessibility and inclusivity. This discipline also extends to collaborative writing processes and version control systems, acknowledging the necessity of teamwork in producing accurate and up-to-date technical documentation. The use of multi-modality and the interfacing of multiple media platforms and sources also plays a role in digital technical writing. In essence, technical writing in the digital age encapsulates the art and science of conveying technical information in a manner that is comprehensible and accessible to diverse audiences in our digitally driven society.
Technical writing is a specialized skill that requires technical knowledge and well-developed communication skills. It involves explaining complex information in a clear, concise, and accessible manner. Through the evolution of technologies like the Internet and smartphones, technical writing has evolved from traditional printed formats to more digital-oriented media. Today, users expect content to be available on various platforms and devices, providing up-to-date information on demand. Technical writers have adapted to these changes by creating compelling, concise, SEO-friendly content in various forms, such as infographics, e-books, podcasts, videos, blogs, GIFs, memes, and other interactive content.


==Overview==
Key factors include integrating multimedia elements, user-centered design principles, and ethical considerations like accessibility and inclusivity. This discipline also extends to collaborative writing processes and version control systems, acknowledging the necessity of teamwork in producing accurate and up-to-date technical documentation. Multimodality and the interfacing of multiple media platforms and sources also play a role in digital technical writing.


===Types of Technical Communication===
=='''Overview'''==
Common types of technical communication include instructions, user guides, reports, proposals, memos, and procedures.{{sfn|Lannon|Gurak|2020|p=30}}  
=== '''Goal of Technical Communication''' ===
{{sfn|Mussack|2021}}
Technical communication is a discipline utilized by various fields such as education, business, and science. In any domain, technical documentation shares a common objective: assisting the audience in achieving a task or goal.{{sfn|Markel|Selber|2019}} This common objective is achieved by the technical writer communicating complex and technical information to the audience in a way that's easy to understand.{{sfn|United States Bureau of Labor Statistics|2023}}


=== Aims of Technical Communication ===
==='''Importance of Research'''===
As much as technical communication is a discipline in and of itself, it also exists within many other disciplines. Examples of technical communication communities can be found among such fields as varied as education, business, and science. Technical documentation within any domain typically embodies a similar aim: to help its audience act toward some sort of task or goal. {{sfn|Markel|Selber|2019}}
Research plays a vital role in technical writing. The main purposes of research are to inform action, gather evidence for theories, and contribute to developing knowledge in a field of study.{{sfn|Zarah|2023}} Research helps build knowledge and facilitate learning, helps society understand issues and increase public awareness, and aids in supporting truth.{{sfn|Zarah|2023}} Proper research provides a strong foundation for efficient technical writing.


=== Characteristics of Technical Communication ===
Major decisions are often based upon results from research. Technical communicators often work with subject matter experts but can also conduct in-depth independent research to produce a technical document. The stages of critical thinking in the research process are{{sfn|Lannon|Gurak|2020|p=145}}:
Because technical communication is intended to guide an audience, it must be assembled in such a way that it is very easily understood. Successful technical documentation is accurate, logically sound, and appropriate. {{sfn|Perelman|1998}} Communication can be said to be accurate in two different understandings: accurate in description and accurate in content. Accurate descriptions are easy to understand. Accurate content provides for the intended result. Communication that is delivered logically is well-organized and clear and can be approached in a manner that will be coherent for most users. Technical information that is appropriate contains elements and steps that are suitable for the intended purpose and audience.
*Asking the right questions. The right questions help define the research problem. The answers found in research are only as good as the questions asked.
*Exploring a balance of views. This provides a broad range of ''evidence''. Ask: What do informed sources say about the topic? On which points do sources agree or disagree? Which sources carry more weight than others?
*Providing adequate ''depth'' into the topic through thorough research. Surface level is reached through popular media. The next level is reached through trade, business, and technical publications. The deepest level is reached through specialized literature such as peer-reviewed journals, government sources, and corporate documents.
*Evaluating the findings. Search for bias in the research. Look for the accurate answer.
*Interpreting the findings. Ensure the final report answers the original research problem.


== Features of Technical Communication ==
The ability to adequately, accurately, and completely research a subject prior to writing technical communication dictates the writer's success.
Technical communication involves conveying complex information to a specific audience. Key features include accuracy, attention to detail, visuals, and clear and concise organization to enhance user understanding. {{sfn|Smirti|2022}}


=== Accuracy ===
=='''History'''==
==='''Technical Writing Profession''' ===
[[File:Joseph D. Chapline.jpg|thumb|Joseph D. Chapline]]
Joseph D. Chapline is considered to be one of the first technical writers, having written in 1949 the first-ever user manual for the Binary Automatic Computer (BINAC), an early personal computer.{{sfn|Malone|2008}} In the 1950s, technical writing as a distinct profession began to take shape when technical writers founded formal organizations, academic programs, and conferences dedicated to the art. One of these key writing associations was the Association of Technical Writers and Editors, also formed in the 1950s. Several of these groups eventually merged, forming the Society for Technical Communication (STC) in 1960.{{sfn|Malone|2011|pp=285-306}} The STC is the world's oldest professional association dedicated to advancing the field of technical communication. The STC promotes adherence to a list of ethical principles. They are legality, honesty, confidentiality, quality, fairness, and professionalism.{{sfn|Society for Technical Communication|2023}}


==== Standards Compliant ====
The need for paperwork ushered in by World War II served as the driving force for the technical writing profession in the United States.{{sfn|Rathbone|1958}} This was years before the computer and photocopier became standard office equipment. During this period, the role of the technical writer revolved solely around words, and their primary work tools consisted of either a pencil or ink pen and paper. The technical writer would draft the document by hand, and a typist or clerical worker would then use a typewriter to transfer the writer's words into a finished document.{{sfn|Rathbone|1958|p=6}} 
Many technical fields have industry-specific regulations and guidelines which are determined by governing bodies and that also have an impact on their technical communication. Furthermore, many organizations may have a style guide that outlines preferred language usage, tone, and formatting.


==== Detailed ====
Advances in technology thrust the technical writing profession into a new era. The technical writer's work may now include not only text but also images, drawings, and computer-based media. The modern technical writer may also be involved in research and information-gathering, speaking with subject matter experts, and selecting document media and project tools.{{sfn|Macari|2023}}
Accurate information that is delivered with precision and specificity is essential to providing communication that is unambiguous and free of discrepancies. It is free of errors and inconsistencies.


==== Objective ====
The projects of today's technical writers range from writing instructions to assemble a living room chair to creating websites.{{sfn|Grimstead|1999}} The titles of today's technical writers may vary as well, such as Information Architects or Documentation Specialists.{{sfn|Grimstead|1999}}
Objective communication is presented in an unbiased and impartial manner and is free of personal opinions. It relies upon facts and evidence and avoids an overly emotional tone. This approach is particularly important in fields where accuracy and impartiality are essential.


===== Clear and Concise =====
'''Future Trends'''
Clear language is organized logically, is not unnecessarily involved, and is easily understood by the target audience. It will avoid needless jargon and complexity. Good technical communication expresses meaning in a way that is straightforward and that avoids redundant words or excessive explanations. It is easy to both absorb and process.


=== Soundness ===
Between 2022 and 2032, the [https://en.wikipedia.org/wiki/Bureau_of_Labor_Statistics, United States Bureau of Labor Statistics] is projecting a 7% job growth for technical writers.{{sfn|United States Bureau of Labor Statistics|2023}}


==== Formatted and Organized ====
[[File:Bureau of labor statistics.jpg|Job growth for tech writing projected by the Bureau of Labor Statistics|center|frame]]
Technical documents should be formatted in a way that is consistent with the norms and standards of applicable professional fields. Additionally, formatting should adhere to guidelines which enhance usability. Information should be logically organized for easy reading comprehension. This may involve using headings, subheadings, bullet points, and numbered lists. A well-organized document enhances the effective transfer of knowledge.


==== Graphic ====
=='''Technical Communication Strategies'''==
Technical communication utilizes visuals strategically to facilitate understanding of textual content. Visuals such as diagrams, charts, graphs or images can enhance understanding on a technical document. When presented properly, they can elucidate difficult concepts and make material accessible to a more diverse audience.
==='''Characteristics of Technical Communication'''===
Technical communication is meant to guide an audience and must be easily understood. Successful technical documentation is accurate, logically sound, and appropriate.{{sfn|Perelman|1998}} Communication can be accurate in description and content. Accurate descriptions are easy to understand. Accurate content provides for the intended result. Communication delivered logically is well-organized, clear, and will be coherent for most users. Appropriate technical information contains elements and steps suitable for the intended purpose and audience.{{sfn|Perelman|1998}}


=== Appropriateness ===  
====Standards Compliant====
Many technical fields have industry-specific regulations and guidelines determined by governing bodies that impact their technical communication. Furthermore, many organizations may have a style guide that outlines preferred language usage, tone, and formatting.{{sfn|Smirti|2022}}


==== Audience-specific ====
====Detail-Oriented====
Where possible, technical communication should be customized to align with the knowledge and needs of its audience. Communication style and tone are tailored to match the audience's knowledge and expertise. It considers factors like technical background, familiarity with the subject, and specific user needs.
Technical communication should be detail-oriented and free of errors and inconsistencies. Accurate information delivered with precision and specificity is essential for unambiguous and discrepancies-free communication.{{sfn|Smirti|2022}}


==Historical Context==
====Objective ====
===Technical Writing Profession===
Objective communication is presented in an unbiased and impartial manner and is free of personal opinions. It relies upon facts and evidence and avoids an overly emotional tone. This approach is particularly important in fields where accuracy and impartiality are essential.{{sfn|Detwiler|2021}}
Joseph P. Chapline is considered to be one of the first technical writers, having written in 1949 the first ever user manual for the Binary Automatic Computer (BINAC), an early personal computer.{{sfn|Malone|2008}} In the 1950s, technical writing as a distinct profession began to take shape when technical writers founded formal organizations, academic programs, and conferences dedicated to the art. One of these key writing associations was the Association of Technical Writers and Editors, also formed in the 1950s. Several of these groups eventually merged, forming the Society of Technical Communication in 1960.{{sfn|Malone|2011|pp=285-306}}


The need for paperwork ushered in by World War II served as the driving force for the technical writing profession in the United States. {{sfn|Rathbone|1958}} This was a time years before the computer and photocopier became common office equipment. At that time the role of the technical writer revolved solely around words, their primary work tools consisted of either a pencil or ink pen and paper. Upon the technical writer writing words on paper, a typist or clerical worker would then type the words with a typewriter.
=====Clear and Concise=====
Technical communication includes a well-structured document. Technical communication should be logically organized, straightforward, and easily understood by the target audience. Planning the document structure allows the technical writer to define the purpose, scope, and main points of the document. The language used should avoid needless jargon and be written in a manner that avoids redundant word usage and/or excessive explanations. {{sfn|Proofed Editors|2020}}<ref>[https://www.linkedin.com/advice/0/how-do-you-write-clear-technical-documents-clients-skills-writing#know-your-audience]</ref>


Advances in technology thrust the technical writing profession into a new era. The work of the technical writer may now also include not only text, but also images, drawings, and computer-based media. The current role of the technical writer is not only to write, but they may also be involved in research and information gathering, speaking with technical experts, and selecting document mediums and project tools. {{sfn|Macari|2023}}
====Formatted and Organized====
Technical documents should be formatted in a way that is consistent with the norms and standards of applicable professional fields. Additionally, formatting should adhere to guidelines that enhance usability. Information should be logically organized for easy reading comprehension. This may involve using headings, subheadings, bullet points, and numbered lists. Formatting details should remain consistent throughout the document.{{sfn|Smirti|2022}}{{sfn|Proofed Editors|2020}}


The projects of today's technical writers can be as varied as writing instructions to assemble a living room chair to creating websites. {{sfn|Grimstead|1999}} And the titles of today's technical writers may vary as well. They may be referred to by names as diverse as information architects to documentation specialists. {{sfn|Grimstead|1999}}
====Graphical====
Technical communication utilizes visuals strategically to facilitate understanding of textual content. Visuals such as diagrams, charts, graphs, or images can enhance understanding of a technical document. When presented properly, visuals can explain difficult concepts and make material accessible to a more diverse audience.{{sfn|AI and the LinkedIn Community|2023}}


== Digital Technologies and Technical Writing==
====Audience-specific====
With the rise of digital technology, technical writing has had to adapt to the needs of a digital era. The predominant impact of such a revolution was that it made technical communication more accessible by increasing the breadth of its viewers. The world-wide web is public, and thus, it can be accessed by anyone with access to the internet. Such a phenomenon can be exploited to increase the audience of a virtual document.  
Technical communication should be customized to align with the knowledge and needs of its audience. Communication style and tone should be tailored to match the audience's level of expertise. Factors such as the users' technical background, familiarity with the subject, and specific requirements should be considered.{{sfn|Viral Nation|2019}} The tone sets the overall mood for the piece.


There are several web-based tools and techniques which allow digital documents to be more easily shared. Online word processors such as [https://www.google.com/docs/about/ Google Docs] and [https://www.microsoft.com/en-us/microsoft-365/sharepoint/collaboration SharePoint] allow documents to be easily disseminated. Comment capability allows audience members to interact about a document with one another as well as with the document author. Relationships created by such online interaction fosters an environment whereby online authors might choose to utilize hypertext to link the works of various others to their personal websites and vice versa. In all, technical documentation posted online can grow a considerable audience over time. However, many aspects of effective technical writing, such as clarity, conciseness, completeness, and correctness, still need to be applied to technical writing created for digital interfaces. {{sfn|Carroll|2010|p=24}}
====Document Design====
Plan the structure of a document so that it is easy to follow and understand. Planning the document structure includes defining a purpose, breadth, and main subjects. Organize the document into a logical and clear order that maintains the purpose of the article. Headings, subheadings, and lists provide coherence to a technical paper. <ref>[https://www.linkedin.com/advice/0/how-do-you-write-clear-technical-documents-clients-skills-writing#know-your-audience]</ref> The appropriateness of documents requires readers to understand the document's message quickly. The document should be of appropriate style and length for the readers' needs.


==Personas in Digital Writing==
==='''Examples of Technical Documents'''===
Personas in the context of digital writing refer to semi-fictional characters that encapsulate the characteristics, behaviors, and needs of target audience segments. They align closely with the principles of user-centered design (UCD).{{sfn|Lucas|2023a}} 
Technical writing encompasses various genres and styles influenced by the information and discourse communities. Not all technical documents are produced by technical writers, as many professionals create various technical documents.{{sfn|Lannon|Gurak|2020|p=32}}  
There are myriad ways to integrate user-centered thinking into the creative process of UX design, and personas are one of the most effective ways to empathize with and analyze users.{{sfn|Goltz|2014}}


==Rhetorical Strategies in the Digital Age==
Common types of technical communication include:{{sfn|Mussack|2021}}
Rhetoric is a communication strategy whose primary goal is to persuade an audience. It is grounded in three foundational concepts first defined by the Greek philosopher Aristotle. These concepts are ''logos'', which engages with the reader’s sense of logic or reason; ''pathos'', which appeals to the reader’s emotions; and ''ethos'', which addresses the audience’s values and the writer’s credibility. Within this framework, writers utilize specific techniques or devices to influence and engage readers. Examples include appealing to an audience’s sense of logic by using factual examples to support a point or evoking emotion through descriptive visual language. {{sfn|Gagich|Zickel|n.d.|pp=34-37}}


In today’s digital age, writers can use digital technologies as rhetorical devices to influence the reader. Electronic images and informational graphics can be incorporated into digital and online documents to illustrate or reinforce points made in the text.{{sfn|Markel|Selber|2019}} Hyperlinks can be used to provide additional information that supports the author's ideas. Nevertheless, the writer's basic task of informing and persuading an audience is the same in digital communication as in other forms of writing.{{sfn|DeVoss|National Writing Project|Eidman-Aadahl|Hicks|2010|p=105}}
====Case Studies====
Case studies are a form of empirical or observational research that consists of in-depth examination of distinct individuals, groups, events, or scenarios. This research can be used to generate qualitative or quantitative data.{{sfn|Johnson-Sheehan|2018|pp=401-404}}


Rhetorical analysis involves analyzing the demographics and habits of an intended audience. The information gathered allows writers to craft messages that appeal to the target audience. In the digital age, websites and social media platforms convey rhetorical messages.{{sfn|Lawrence|2022|pp=6-14}}
====Data Sheets====
A data sheet, also known as a technical datasheet, is a document used to describe and summarize the characteristics of a product, material, component, or technology.{{sfn|Industrial Data Associates|2020|p=}}


==Search Engine Optimization (SEO)==
====Descriptions====
SEO refers to the practice of optimizing online content to enhance its visibility and ranking on search engine results pages (SERPs), making it a crucial skill for digital writers.{{sfn|Lucas|2023b}} To optimize content for SEO means to have the goal of SEO in mind at the time of designing, creating, and writing a web page for publication. Using keywords and alt-text are two examples of optimizing content for SEO. {{sfn|Barr|2010|loc=chpt. 17}}
Descriptions are concise explanations of procedures and processes that assist readers in understanding how something works. Product descriptions and process descriptions are the two main types of technical descriptions.{{sfn|Lannon|Gurak|2020|pp=443-453}}


=== Using Keywords ===
*Product: provides detailed information about a specific item, including its features, specifications, and benefits.
Keywords are the words that search engines crawl a website for and index as the page's most important words. Based on other pages using the same keywords, the website is added into the search engine results pages from best matches to worse matches. Depending on where the website falls in that scale based on the specific keywords being searched by a user, influences where the website pops up in the associated search results.{{sfn|Lucas|2023b}} To optimize a website's keywords, you should begin with researching keywords on your own website and ensure that you have an XML [https://en.wikipedia.org/wiki/Sitemaps sitemap] so search engine's such as [https://en.wikipedia.org/wiki/Google Google] can crawl your web pages for updated information. In addition to using keywords, updating a page's metadata information can also help with showing up on SERPs. Using title and header tags as well as meta descriptions for content also helps optimize a website's ratings in SERPs.{{sfn|Lucas|2023b}}
*Process: provides step-by-step instructions on how to perform a particular task or achieve a specific outcome.


=== Using Alt-Text ===
====Documentation====
Alt-Text (alternative text), or [https://en.wikipedia.org/wiki/Alt_attribute Alt Attributes], is a practice that increases the usability and accessibility of a web page for users. Alt-Text is often used for visual elements that cannot be displayed in a different format but still provides description of the element for screen readers or users that may have a disability. Alt-Text also improves a website's SEO as a form of content optimization.{{sfn|Lucas|2023b}}
Documentation comprises various texts that allow users to accomplish tasks or gain information. It generally falls into three categories, which can be defined as follows:
*Instructions: Text that describes how to complete a task, often offering numbered steps. Examples include how to download software or assemble a product.{{sfn|Balzotti|2022|p=167}}
* Specifications: Communications that deliver technical details on how a product is put together or a specific operation is executed. Also known as "specs," these texts may be written by engineers or technicians.{{sfn|Johnson-Sheehan|2018|p=205}}
*Procedures and Protocols: Guidelines to ensure consistency, quality, and safety in the workplace. For example, a hospital may provide staff with procedures on how to adapt operations during an emergency, such as a power outage.{{sfn|Johnson-Sheehan|2018|p=205}}


=== Social Media Presence ===
====Email====
Sharing content from a website across different social media platforms is another way to create SEO optimization. This technique can help with being seen as legitimate and improves visibility of the website overall. Additionally it can drive traffic and enables back-linking to occur when other websites have the ability to also link to the website.{{sfn|Lucas|2023b}}
[[File:Email.png|thumb|201x201px|Image of an email]]
Emails are the primary form of communication in the workplace, used for both internal and external communication. They facilitate information exchange, idea exchange, and activity coordination.{{sfn|Lannon|Gurak|2020|p=335}} Emails should be brief, concise, readable, and targeted to specific audiences with specific subject lines.{{sfn|Lannon|Gurak|2020|p=348}}  


==Digital Documentation ==
====Letters====
Digital documentation is the conversion of physical documents into digital files, enabling easier access, retrieval, and sharing of information. It includes features like searchability, version control, and security measures to ensure data integrity and confidentiality.{{sfn|Lucas|2014}}
Letters are a traditional form of communication most often used by employees to communicate with individuals outside of a company or organization. They are typically written on company letterhead. Today, letters are sent either by U.S. mail or electronically.{{sfn|Johnson-Sheehan|2018|p=139}}


===Characteristics of Digital Documents===
====Memos====
A memo (short for memorandum) is an official communication, usually a message from the company, a manager or director, or another person or group acting in an official capacity, used to communicate with others within the same organization.{{sfn|Lannon|Gurak|2020|p=353}}


==== Electronic Format ====
====Press Releases====
Digital documents exist in electronic formats, which means they are stored and transmitted as binary data. This format allows for efficient storage, retrieval, and transmission of information via electronic devices.{{sfn|Lucas|2023c}}
A press release can be an organization's announcement or latest news distributed to media outlets with information for the public. A press release can be called a press statement, news release, or media release.{{sfn|Pradhan|2021}}


==== Non-Tangible ====
====Proposals====
A proposal is a document that identifies an existing problem or opportunity and outlines a comprehensive strategy for addressing it. Organizations create ''internal'' proposals to describe programs and projects that meet specific operational needs, such as a plan to replace an outdated software system. Companies develop ''external'' proposals for potential customers or clients. These documents detail new products, services, or initiatives that a company will implement to address a specific customer concern.{{sfn|Johnson-Sheehan|2018|p=245}}
 
====Reports====
A report is a concise, easily understandable document that presents technical information in a clear, organized format, allowing readers to access varying levels of information. Reports are categorized as informal, such as briefs, and formal, such as research, scientific, and completion reports.{{sfn|Johnson-Sheehan|2018|loc=chpt 10 & 11}}
 
=====Informal or Brief Reports=====
Informal or brief reports provide an objective overview of an organization's current state, past events, and future plans, ensuring that readers are well-informed about the organization's operations. Some examples include{{sfn|Johnson-Sheehan|2018|pp=285-288}}:
 
*Progress reports are used to inform management about the progress or status of a project.
* White papers and briefings educate management or clients about important issues.
*Incident reports objectively focus on presenting facts relating to an accident or irregular occurrence.
*Laboratory reports describe experiments, tests, or inspections.
 
=====Formal Reports=====
A formal report is a factual and data-driven response to a research question.
*Research reports present the findings of a study.
*Scientific research reports outline the process, progress, and results of technical or scientific research or the current state of a research problem.
*Completion reports assess the outcomes of a project or initiative and provide feedback to management or the client.
 
====Resumes ====
Resumes offer an overview of an individual’s educational credentials and professional experience and often are used to demonstrate an applicant’s qualifications to potential employers.{{sfn|Johnson-Sheehan|2018|p=100}} They may be organized in various ways, but two common approaches are chronologically and by skills.
 
Chronological resumes demonstrate the sequence of education and employment history and detail a person’s tasks, responsibilities, and achievements in each successive role.
 
Skills resumes provide employment history, but the primary focus is to highlight how an individual applied distinct skills and experiences across various professional positions.{{sfn|Markel|Selber|2019|pp=411-412}}
 
====User Guides====
A user guide is an instructional manual created to help consumers use the product, service or system. A user guide typically includes step-by-step instructions.{{Sfn|Wainaina|2022}}
 
=='''Digital Writing Strategies'''==
 
==='''Characteristics of Digital Documents'''===
 
====Electronic Format ====
Digital documents exist in electronic formats, which means they are stored and transmitted as binary data. This format allows for efficient storage, retrieval, and transmission of information via electronic devices.{{sfn|Lucas|2023c}} Digital documentation is the only method to meet a critical challenge of the relatively new concept of "knowledge management" that applies to all organizations. A digital knowledge management system is crucial to an organization so everyone can access information created by employees who are no longer with the organization or to allow cross-referencing with other seemingly unrelated departments.{{sfn|IBM}}
 
====Non-Tangible ====
Unlike paper documents, digital documents lack physical presence. They are intangible and exist as electronic files, residing on devices or in the cloud.{{sfn|Lucas|2023c}}
Unlike paper documents, digital documents lack physical presence. They are intangible and exist as electronic files, residing on devices or in the cloud.{{sfn|Lucas|2023c}}


====Accessibility ====
====Accessibility====
Website content should be designed in accordance with Web Content Accessibility Guidelines (WCAG) to ensure that individuals with disabilities are able to access the same information as those without disabilities.{{sfn|WAI|2022}} It is a legal requirement to include accessibility features in website design.{{sfn|WCAG|2023}} There are four different types of impairment that can affect how a user interacts and perceives digital documents: vision, mobility, auditory, and cognitive.{{sfn|Robbins|2018|p=42}}Digital documents will need to be optimized so that information can be accessed by hardware and software tools used by people with disabilities.{{sfn|Barr|2010|pp=103-104}}
Website content should be designed in accordance with Web Content Accessibility Guidelines (WCAG) to ensure that individuals with disabilities are able to access the same information as those without disabilities.{{sfn|WAI|2022}} It is both ethically imperative and a legal requirement to include accessibility features in website design.{{sfn|WCAG|2023}}
 
There are four different types of impairment that can affect how a user interacts and perceives digital documents: vision, mobility, auditory, and cognitive.{{sfn|Robbins|2018|p=42}} Digital documents will need to be optimized so that information can be accessed by hardware and software tools used by people with disabilities.{{sfn|Barr|2010|pp=103-104}} Designing accessible digital content increases the technical writer's ability to engage with a broader audience base.{{sfn|Lucas|2023i}}


====Readability====
====Readability====
Digital documents rely on the "Seven Cs" of precise writing to be effective and increase readability. Forms of technical writing must have readability. Readability is a term used to determine whether the content has clarity, conciseness and courtesy.{{sfn|Zeleznik|Burnett|Benson|1999|p=207}} The other four Cs are coherent, concrete, correct and complete.{{sfn|Last|2019}}
[[File:Inverted pyramid.jpg|thumb|From "Writing for the Web" by Lynda Felder: This pyramid explains how to best display information in a paragraph quickly for readability and scannability]]
Digital documents rely on the "Seven Cs" of precise writing to be effective and increase readability. Forms of technical writing must have readability. Readability is a term used to determine whether the content has clarity, conciseness, and courtesy.{{sfn|Zeleznik|Burnett|Benson|1999|p=207}} The other four Cs are coherent, concrete, correct, and complete.{{sfn|Last|2019}}


====Scannability====
====Scannability====
A document's scannability is determined by the ease in which it can be scanned to determine meaning. Readers often scan pages for words and phrases that align with their task or interests, as well as for trigger words that are deeply ingrained.{{sfn|Krug|2014|p=23}} The most effective web content is concise and simple to scan, making it easy for users to find the important information. Breaking up text into interesting, easy-to-read sections helps users quickly find information. {{sfn|Barr|2010|p=103}}
A document's scannability is determined by the ease in which it can be scanned to determine meaning. Readers often scan pages for words and phrases that align with their task or interests, as well as for trigger words that are deeply ingrained.{{sfn|Krug|2014|p=23}} The most effective web content is concise and simple to scan, making it easy for users to find the important information. Breaking up text into interesting, easy-to-read sections helps users quickly find information.{{sfn|Barr|2010|p=103}} Ways to improve a document's scannability include implementing visual elements, white space, concise language, highlighting, and emphasis.{{sfn|Lucas|2023j}}


==== Ease of Reproduction and Distribution ====
==== Ease of Reproduction and Distribution====
Digital documents are easily copied and distributed. They can be duplicated without any loss of quality, making it simple to share information widely and at minimal cost.{{sfn|Lucas|2023c}}
Digital documents are easily copied and distributed. They can be duplicated without any loss of quality, making it simple to share information widely and at minimal cost.{{sfn|Lucas|2023c}}


====Hyperlinking====
====Hyperlinking====
Hyperlinking is a quick and efficient method for directing readers to relevant information in digital documents, facilitating seamless navigation between sections, references, and external resources.{{sfn|Carroll|2010|p=79}}
Hyperlinking is a quick and efficient method for directing readers to relevant information in digital documents, facilitating seamless navigation between sections, references, and external resources.{{sfn|Carroll|2010|p=79}} Hyperlinking also allows readers the opportunity to do further research by reading where the information originated.


====Multimedia====
====Multimedia====
Digital documents can incorporate multimedia elements like images, audio, video, and interactive content, enhancing engagement through visual and auditory elements. Multiple media formats work best when sharing new, complicated ideas.{{sfn|Carroll|2010|p=36}} Increasing multimodality on a website improves engagement, usability, and accessibility. This can improve the impact of the website's standings in SERPs.{{sfn|Carroll|2010|p=280}}
Digital documents can incorporate multimedia elements like images, audio, video, and interactive content, enhancing engagement through visual and auditory elements. Multiple media formats work best when sharing new, complicated ideas.{{sfn|Carroll|2010|p=36}} Increasing multimodality on a website improves engagement, usability, and accessibility. This can improve the impact of the website's standings in search engine results pages (SERPs).{{sfn|Carroll|2010|p=280}}


====Version Control====
====Version Control====
Version control is a characteristic of digital documents that allows for the tracking of edits and revisions to digital documents. In collaborative writing, version control helps maintain the document with accountability and transparency.{{sfn|Lucas|2023d}}
Version control is a characteristic of digital documents that allows for the tracking of edits and revisions to digital documents. In collaborative writing, version control helps maintain the document with accountability and transparency.{{sfn|Lucas|2023d}}


==== Remote Collaboration ====
====Remote Collaboration====
One form of collaborative technical writing is a wiki, which is a "Web site developed collaboratively by a community of users, allowing any user to add and edit content.{{sfn|Lucas|2021}} One of the predominant elements of a wiki is that it is defined as being open source. As a result, anyone can modify it regardless of their geographic locations.
One form of collaborative technical writing is a wiki, a "website developed collaboratively by a community of users, allowing any user to add and edit content."{{sfn|Lucas|2021}} One of the predominant elements of a wiki is that it is defined as being open source. As a result, anyone can modify it regardless of their geographic location.


==== Security Measures ====
====Security Measures====
Digital documents can be protected with encryption, passwords, and access controls to safeguard sensitive information. These security measures enhance data protection and privacy.{{sfn|Lucas|2023c}}
Digital documents can be protected with encryption, passwords, and access controls to safeguard sensitive information. These security measures enhance data protection and privacy.{{sfn|Lucas|2023c}}


Line 124: Line 176:
Digital documents have a smaller environmental footprint compared to paper documents, as they reduce the need for paper production, printing, and transportation.{{sfn|Lucas|2023c}}
Digital documents have a smaller environmental footprint compared to paper documents, as they reduce the need for paper production, printing, and transportation.{{sfn|Lucas|2023c}}


==== Dynamic Updates ====
==== Dynamic Updates====
Online digital documents can be updated dynamically, ensuring that users always have access to the most current information. This is particularly valuable in fast-changing fields.{{sfn|Lucas|2023c}}
Online digital documents can be updated dynamically, ensuring that users always have access to the most current information. This is particularly valuable in fast-changing fields.{{sfn|Lucas|2023c}}


==== Global Accessibility ====
====Global Accessibility====
Digital documents can be shared globally, transcending geographical boundaries and time zones. They support international collaboration and the dissemination of knowledge on a global scale.{{sfn|Lucas|2023c}}
Digital documents can be shared globally, transcending geographical boundaries and time zones. They support international collaboration and the dissemination of knowledge on a global scale.{{sfn|Lucas|2023c}}


==== Data Integration ====
====Data Integration====
In business and research settings, digital documents can integrate with databases and data analysis tools. This integration streamlines data collection, analysis, and reporting processes.{{sfn|Lucas|2023c}}
In business and research settings, digital documents can integrate with databases and data analysis tools. This integration streamlines data collection, analysis, and reporting processes.{{sfn|Lucas|2023c}}


==== Data Analytics ====
====Data Analytics====
Digital documents can be subjected to data analytics techniques, allowing organizations to extract valuable insights from large volumes of textual data, which can inform decision-making and strategy.{{sfn|Lucas|2023c}}
Digital documents can be subjected to data analytics techniques, allowing organizations to extract valuable insights from large volumes of textual data, which can inform decision-making and strategy.{{sfn|Lucas|2023c}}


==Examples of Digital Documents==
==='''Examples of Digital Documents'''===
In technical and professional writing, digital documentation takes various forms. These methods streamline the sharing of technical information, enhance collaboration, and ensure easy accessibility within professional settings, contributing to efficient communication and knowledge dissemination.
Digital documentation is the conversion of physical documents into digital files, enabling easier access, retrieval, and sharing of information. It includes features like searchability, version control, and security measures to ensure data integrity and confidentiality.{{sfn|Lucas|2023c}} In technical and professional writing, digital documentation takes various forms. These methods streamline the sharing of technical information, enhance collaboration, and ensure easy accessibility within professional settings, contributing to efficient communication and knowledge dissemination.{{sfn|Lucas|2023c}}


=== Infographics ===
====Infographics====
Infographics, shared as digital documents, typically combine text, graphics, and illustrations to convey complex concepts or data in a concise and visually appealing format. Infographics are often used to simplify information, making it more accessible to a broader audience, and are found in presentations, reports, websites, and educational materials. {{sfn|Lannon|Gurak|2020|pp=292-293}}
Infographics, shared as digital documents, typically combine text, graphics, and illustrations to convey complex concepts or data in a concise and visually appealing format. Infographics are often used to simplify information, making it more accessible to a broader audience, and are found in presentations, reports, websites, and educational materials.{{sfn|Lannon|Gurak|2020|pp=292-293}}


=== Presentations ===
====Presentations====
[[File:Microsoft powerpoint.png|thumb|Logo for Microsoft PowerPoint]]
Presentations created with [https://en.wikipedia.org/wiki/Microsoft_PowerPoint PowerPoint] or [https://en.wikipedia.org/wiki/Google_Slides Google Slides] are vital for professional communication and knowledge sharing. They condense complex information into visually appealing slides for effective presentations by using photos, videos, graphics, charts, and graphs.{{sfn|Parkinson|2018|loc=chpt. 4}}
Presentations created with [https://en.wikipedia.org/wiki/Microsoft_PowerPoint PowerPoint] or [https://en.wikipedia.org/wiki/Google_Slides Google Slides] are vital for professional communication and knowledge sharing. They condense complex information into visually appealing slides for effective presentations by using photos, videos, graphics, charts, and graphs.{{sfn|Parkinson|2018|loc=chpt. 4}}


==User Experience==
====Blogs====
User experience is how a product works from the perspective of the user. Digital documents can be created with efficient user experiences by focusing on user-centered design. {{sfn|Garrett|2011|p=17}}
A blog, short for "weblog," is an informational website organized into short articles called posts, typically a chronologically ordered series of website updates written and organized like a traditional diary.{{sfn|Bair|2014|p=7}} They are regularly updated, providing readers with insights on a specific topic or subject. Blogs serve various purposes, including sharing opinions, providing news, offering educational content, and documenting personal experiences.{{sfn|Rose|Garret|2012|p=2}}
 
====Forums====
Forums are an example of a digital document that allows users to seek and provide information within a community. Forums are gathering information points users provide instead of technical writers. Companies can utilize forums as part of their technical communication with consumers in the digital environment, expanding past the traditional technical communication of a user manual.{{sfn|Ellingson|2014}}
 
==='''Personas in Digital Writing'''===
Personas in the context of digital writing, which is writing composed, created, and read in digital environments, refer to semi-fictional characters that encapsulate the characteristics, behaviors, and needs of target audience segments. They align closely with the principles of user-centered design (UCD).{{sfn|Lucas|2023a}} There are myriad ways to integrate user-centered thinking into the creative process of user experience (UX) design, and personas are one of the most effective ways to empathize with and analyze users.{{sfn|Goltz|2014}}
 
Personas may guide the creation of documentation and tutorials catering to different user needs. It is crucial to adjust the language and tone to match the persona's preference. Different personas can influence and guide the design of the project.
 
Along with adjusting tone and language to suit the desired user, personas can be used to ensure the purposed digital document properly informs the reader with the correct and accurate information the user seeks.
 
=== '''Rhetoric'''===
[https://en.wikipedia.org/wiki/Rhetoric Rhetoric] is a communication strategy whose primary goal is to persuade an audience. It is grounded in three foundational concepts first defined by the Greek philosopher Aristotle. These concepts are ''logos'', which engages with the reader’s sense of logic or reason; ''pathos'', which appeals to the reader’s emotions; and ''ethos'', which addresses the audience’s values and the writer’s credibility. Within this framework, writers utilize specific techniques or devices to influence and engage readers. Examples include appealing to an audience’s sense of logic by using factual examples to support a point or evoking emotion through descriptive visual language.{{sfn|Gagich|Zickel|n.d.|pp=34-37}}
 
In today’s digital age, writers can use digital technologies as rhetorical devices to influence the reader. Electronic images and informational graphics can be incorporated into digital and online documents to illustrate or reinforce points made in the text.{{sfn|Markel|Selber|2019|pp=182-186}} [[#Hyperlinking|Hyperlinks]] can provide access to additional information that supports authors’ ideas and enhances their credibility.{{sfn|Lucas|2023g|}} Nevertheless, the writer's basic task of informing and persuading an audience is the same in digital communication as in other forms of writing.{{sfn|DeVoss|National Writing Project|Eidman-Aadahl|Hicks|2010|p=105}}
 
Digital writers must therefore consider specific elements that compose the rhetorical context in which texts are created and delivered. Such elements may include evaluating the demographics, habits, and needs of an intended audience; determining the overall objective of the communications; and deciding what technologies will be used to create the content. Together, this analysis allows writers to craft messages that both appeal to and inform the target audience. In the digital age, such rhetorical messages may be conveyed through websites, social media, and other digital platforms.{{sfn|Lawrence|2022|pp=6-14}}
 
==='''Tools for Digital Technology'''===
With the rise of digital technology, technical writing has had to adapt to the needs of a digital era. Technical writers can use various tools to author and present their documents.
 
====Content Management Systems (CMS)====
A content management system (CMS) is a software application that allows users to create, manage, and modify digital content on a website. It provides a user-friendly interface and tools to easily organize, publish, and update content, including text, images, videos, and documents. Additionally, CMSs often offer features like user permissions, version control, and Search Engine Optimization (SEO) to enhance the overall website management experience.{{sfn|Carroll|2010|p=129}} Some popular examples of CMS include [https://wordpress.com/ WordPress], [https://www.wix.com/ Wix], and [https://www.blogger.com/about/?bpli=1 Blogger].
 
====Image Processing Software====
Image processing software plays a valuable role in technical and digital writing by facilitating the creation and enhancement of visuals. Documentation and tutorials help optimize images to convey processes or procedures effectively. Whether for screen captures illustrating software interfaces, data visualizations, or graphics for digital content, image processing tools contribute to creating clear and visually appealing materials.{{sfn|Robbins|2018|p=664}} These tools, such as [https://www.adobe.com/ Adobe] and [https://www.canva.com/ Canva], enhance the visual impact of technical and digital writing, ensuring that images are optimized, informative, and engaging for the audience.
 
====Word Processors====
[[File:Word processor logos.jpg|thumb|The logos of popular word processors: (L-R Clockwise) Apple Pages, Google Docs, SharePoint, Microsoft Word. ]]
Word processors are software applications designed for creating, editing, and formatting documents on a computer. They provide many features, such as spell-checking, checking grammar, and inserting images and tables. These programs are typically used for writing essays, creating reports, or drafting professional documents.{{sfn|Carroll|2010|p=229}} Some popular software applications are [https://www.microsoft.com/en-us/microsoft-365/word Microsoft Word], [https://www.google.com/docs/about/ Google Docs][https://www.microsoft.com/en-us/microsoft-365/sharepoint/collaboration , SharePoint], and [https://www.apple.com/pages/ Apple Pages]. These programs allow documents to be readily disseminated. Comment capability enables audience members to interact about a document with one another and the author. 
 
====Text Editors====
Text editors are fundamental technical and digital writing tools, offering a platform for creating and manipulating plain text files. They are indispensable for programming tasks, providing syntax highlighting and code folding features. Text editors are commonly used to write code, markup languages (HTML, XML, Markdown), and edit configuration files.{{sfn|Godson|p=37-41}} Notable examples include [https://apps.microsoft.com/detail/windows-notepad/9MSMLRH6LZF3?hl=en-US&gl=US Notepad] (Windows), [https://support.apple.com/guide/textedit/welcome/mac TextEdit] (macOS), and [https://notepad-plus-plus.org/ Notepad++]. Whether for programmers, writers, or system administrators, text editors play a crucial role in content creation and technical work.
 
==='''Search Engine Optimization (SEO)'''===
SEO refers to the practice of optimizing online content to enhance its visibility and ranking on search engine results pages (SERPs), making it a crucial skill for digital writers.{{sfn|Lucas|2023b}} To optimize content for SEO means to have the goal of SEO in mind at the time of designing, creating, and writing a web page for publication. Using keywords and alt text are two examples of optimizing content for SEO.{{sfn|Barr|2010|loc=chpt. 17}}
 
====Keywords====
Keywords are the words that search engines scan a website for and index as the page's most important words. Based on other pages using the same keywords, the website is added to the search engine results pages from best matches to worst matches. The position of a website in search results is influenced by where it ranks on a scale determined by the keywords that a user searches for.{{sfn|Lucas|2023b}} To optimize a website's keywords, you should begin with researching keywords on your own website and ensure that you have an XML [https://en.wikipedia.org/wiki/Sitemaps sitemap] so search engines such as [https://en.wikipedia.org/wiki/Google Google] can scan your web pages for updated information. In addition to using keywords, updating a page's metadata information can also help with showing up on SERPs. Using title and header tags as well as meta descriptions for content also helps optimize a website's ratings in SERPs.{{sfn|Lucas|2023b}}
 
====Alt Text====
Alt text (alternative text), or [https://en.wikipedia.org/wiki/Alt_attribute alt attributes], is a practice that increases the usability and accessibility of a web page for users. Alt text is often used for visual elements that cannot be displayed in a different format but still provides description of the element for screen readers or users that may have a disability. Alt text also improves a website's SEO as a form of content optimization.{{sfn|Lucas|2023b}}
 
====Social Media Presence====
[[File:Facebook logo.png|thumb|212x212px|Facebook Logo]]
Sharing content from a website across different social media platforms is another way to create SEO optimization. This technique can help with being seen as legitimate and improves the visibility of the website overall. Additionally, it can drive traffic and enable backlinking, where other websites can link to the website.{{sfn|Lucas|2023b}}
 
====Goals of Searching: The User's Perspective====
A user of search engines formulates queries by using keywords or posing questions. One of the most important elements of building an SEO strategy for a website is developing a thorough understanding of the psychology of your target audience and how they use words and concepts to obtain information about the services and/or products you provide. Once you understand how the average search engine user—and, more specifically, your target audience—utilizes query-based search engines, you can more effectively reach and keep those users.{{sfn|Enge|Spencer|Stricchiola|2022|p=9}}
 
==='''User Experience'''===
User experience (UX) is how a product works and is experienced from the user's perspective.{{sfn|Garrett|2011|p=6}} By creating a positive user experience, technical writers can ensure the intended message is effectively communicated and retained. UX design methods include user-centered design, information architecture, responsive design, multimodality, and usability.  
 
====User-Centered Design====
User-centered design (UCD) is implemented by considering the user and their needs throughout the entire development of a product.{{sfn|Garrett|2011|p=17}} The approach of UCD in technical writing consists of the following methodologies:{{sfn|Lucas|2023e}}
 
*'''User Research''': the act of conducting thorough research through surveys, interviews, and usability testing to gain a better understanding of user needs and experiences when using a digital document
*'''Ideation and prototyping''': the process of creating digital designs and prototypes to assist with exploring possible solutions to meet user needs
*'''Usability testing''': the act of having users interact with digital document designs and then adjusting the design based on user feedback
*'''Implementation''': the stage in which the design is implemented after adjusting from prior testing
*'''Evaluation''': the stage in which the digital document is assessed to ensure that it is meeting user needs
*'''Maintenance and updates''': to maintain a digital document based on user feedback and changing needs
 
====Information Architecture====


=== User-Centered Design ===
To ensure a digital document has effective UX design and accessible information, technical writers must construct a clear and organized information architecture (IA). IA is a design principle that organizes information so that it is easily found and understood by users, prioritizing their needs and reducing information overload. A design challenge is making IA understood across multiple digital experiences, changing the navigation structure to fit different media while staying logical and consistent for the user.{{sfn|Rosenfeld|Morville|Arango|2006|pp=1, 17-18}} IA that is not constructed well can confuse the user and could cause them to give up their search of information in frustration.{{sfn|Garrand|2006|p=12}}
The approach of user-centered design (UCD) in technical writing consists of the following methodology{{sfn|Lucas|2023e}}:


==== User Research ====
The architecture components of IA can be divided into four different categories:{{sfn|Rosenfeld|Morville|Arango|2006|p=90}}
User research is the act of conducting thorough research through surveys, interviews, and usability testing to gain a better understanding of user needs and experiences when using a digital document.


==== Ideation and Prototyping ====
*'''Organization systems''': how information is categorized and organized for user understanding
Ideation and prototyping refers to the process of creating digital designs and prototypes to assist with exploring possible solutions to meet user needs.


==== Usability Testing ====
*'''Labeling systems''': how information is represented
Usability testing refers to the act of having users interact with digital document designs and recording and adjusting the design based on user feedback.


==== Implementation ====
*'''Navigation systems''': how users browse information and navigate between pages
Implementation is the stage in which the design is implemented after making adjustments from prior testing.


==== Evaluation ====
* '''Searching systems''': how users search for specific information
Evaluation refers to the stage in which the digital document is assessed to ensure that it is meeting user needs.


==== Maintenance and Updates ====
====Responsive Design====
Maintenance and updates are required in order to maintain a digital document based on user feedback and changing needs.


==Ethical Considerations==
Responsive design is a strategy that appropriately updates the layout and content of a website or document in relation to the screen size, device, and/or orientation, allowing the site or document to be easily viewed and navigated regardless of the device used. With the increased use of mobile devices, web content should be constructed with proper responsive web design (RWD) to ensure effective UX and usability on those devices.{{sfn|Robbins|2018|p=485}}
In technical workplaces, resolving ethical dilemmas will be part of one's job. Resources, time, and reputations are at stake, so one will feel pressure to overpromise, underdeliver, bend the rules, cook the numbers, or exaggerate results. Technical fields are also highly competitive, so people sometimes stretch a little further than they should. Ethical dilemmas can force one into situations in which all choices seem unsatisfactory.{{sfn|Johnson-Sheehan|2018|pp=71-84}}


The Society for Technical Communication (STC) is the world's oldest professional association dedicated to advancing the field of technical communication.{{sfn|STC|2023}} The STC promotes adherence to a list of ethical principles. They are legality, honesty, confidentiality, quality, fairness, and professionalism.{{sfn|STC|2023}}
There are several design strategies that can be implemented that will increase the success of RWD:{{sfn|Robbins|2018|p=487}}


Technical communicators also have to be careful to avoid plagiarism, or taking ideas, thoughts, or words from someone else and passing them off as one's own.{{sfn|Carroll|2010|p=280}}
*'''Fluid layout''': Responsive sites can be constructed using a fluid layout (or flexible grid) system that will allow content to adjust and flow according to the available screen space.
 
*F'''lexible and responsive images''': Images and other embedded media can be instructed to fit their containers instead of remaining at a fixed size. Images with varying resolutions can also be swapped according to screen size to avoid high-resolution images on smaller devices.
 
*'''CSS media queries''': Media queries can be written into the CSS (Cascading Style Sheet), instructing the site's construction according to screen width and orientation. Adding breakpoints for several screen sizes allows pages to be designed for specific devices.
 
*'''Content hierarchy''': Carefully constructing content that is organized for the user and creating a hierarchy of content that prioritizes user needs is necessary to ensure effective user experience and navigation across multiple screen sizes.{{sfn|Robbins|2018|p=499}}
 
====Multimodality====
While responsive design focuses on the system or interface response to user inputs, multimodality refers to integrating multiple modes of communication to evaluate how effective communication can be in the digital age.{{sfn|Lucas|2023h|p=}}
 
There are essential elements to multimodality that improve the UX experience for readers in digital documents:
 
*'''Accessibility''':  Documents that contain multimodal, or multimedia elements, allow for diversity in obtaining information to cater to diverse learning styles and abilities. For example, a slideshow presentation that contains audio will help aid those with visual impairments.
*'''Engagement''': Combining static information with visuals, such as images, videos, or interactive modules, can create a more engaging experience for readers in the digital age.
*'''Clarity and Comprehension''': Jargon-heavy text and complex ideas are able to be showcased in charts, diagrams, and infographics that are easily able to clarify concepts better than text.
*'''Persuasion''': Combining the elements listed above may allow for the creators to influence their audience.
 
====Usability====
 
Technical writers must create documents and websites that meet the expectations of their readers and users. In doing so, writers increase the usability of their site or document.{{sfn|Garrand|2006|p=26}} Usability consultant Steve Krug considers the most important rule for ensuring a site or document is usable is by making pages self-evident and allowing the user not to have to think about actions.{{sfn|Krug|2014|pp=11-18 }} A website that is well designed for usability means that the users will not have any questions about the content or functions of the site. The site will have a clear hierarchy, use standard web design principles, have well-defined content areas, include noticeable and simple links, and limited distractions.{{sfn|Carroll|2010|p=69}}
 
A document or website written for usability can be easily scanned by using the following concepts:{{sfn|Garrand|2006|pp=25-26}}
 
*Highlighting keywords
 
*Writing descriptive headings and subheadings
 
*Incorporating bulleted list
 
*Constructing shorter paragraphs
 
*Implementing an inverted pyramid writing style by beginning with the most important information


Technical communicators have ethical standards to which they must abide. The standards are divided into three primary categories. They are the employer, the public, and the environment.{{sfn|Markel|2009}}
*Decreasing the word count of traditional writing


=== The Employer ===
*Using clear and concise language and, when appropriate, visual aids
Obligations to one's employer include competence and diligence, honesty and candor, confidentiality, and loyalty.{{sfn|Markel|2009}} The technical communicator must adhere to these obligations so that he/she does not harm the reputation or operation of the employer.


Technical communicators may occasionally work for an organization with strict privacy policies that prohibit them from using the documents they create outside of the organization. It is important for ethical communicators to follow the privacy policy for their organization because unauthorized release of information could lead to consequences up to and including termination.{{sfn|Balzotti|2022|p=83}}
====Remediation====
Remediation is the process through which new media forms borrow elements from older media forms and transform and re-contextualize them. As media evolves, so do the ways users can consume it. When first introduced, remediation was described as a type of reformation, such as taking a paper letter and turning it into an email.{{sfn|Bolter|Grusin|1999|p=59}} Today, remediation of a digital document often adds to the user experience by enhancing the document. An example of remediation is making a document more accessible by adding a text-to-speech feature for users with poor vision or adding a tutorial to an electronic manual.


=== The Public ===
This can be simplified into two key principals:
Organizations are obligated to treat customers fairly. Technical communicators must convey that the products or services an organization sells are safe and effective.{{sfn|Markel|2009}}


=== The Environment ===
* '''Immediacy and Hypermediacy:''' Immediacy refers to the desire to transcend a medium, while hypermediacy takes the medium and infuses it through the new medium.{{sfn|Bolter|Grusin|1999|p=53}}{{sfn|Lucas|2023k}}
Technical communicators have an obligation to the environment. This obligation includes alerting their supervisors, managers, and executive leadership to products or processes that are detrimental to the environment. Protecting the environment can be costly, however, and organizations may consider ignoring legal guidelines to save money.{{sfn|Markel|2009}} Yet, failure to adhere to U.S. Environmental Protection Agency regulations also has financial implications. For example, the penalty for mishandling hazardous waste is five years and/or up to $50,000 for each day of the violation.{{sfn|EPA|2023}}
* '''Transparent and Opaque Media:''' Transparent media allows the content to take center stage, while opaque media makes users aware of the medium's presence.{{sfn|Bolter|Grusin|1999|p=53}}{{sfn|Lucas|2023k}}  


===Disinformation===
Overall, remediation is necessary to create a multimodal document in the digital age.
One major ethical concern in all forms of writing, but especially in digital writing, is the creation and spread of disinformation. Disinformation, often referred to as "[[w:Fake news|fake news]]," is information that is purposefully spread as false or misleading and is a sub-type of misinformation.{{sfn|Lawrence|2022|loc=section 3.7}} Modern communication technologies allow for the spread of information to occur at a fast pace. Social media is one area where the spread of disinformation occurs regularly. Some social media sites, such as Facebook, have begun to flag certain articles posted on the site as being questionable in their representation of facts or occurrences. Despite the widespread understanding and use of disinformation available today, digital writers need to be aware of their intent and the audience's needs and wants from their digital communication.{{sfn|Lucas|2023f}} Ethical considerations regarding citing sources, cross-referencing information, and using primary sources are good practices for maintaining ethical standing and credibility as a digital writer.


To help mitigate the problem of disinformation, technical writers should utilize gatekeepers. These individuals verify the accuracy of the information before it is distributed to primary readers. This helps protect the author from any ethical and/or legal issues.{{sfn|Balzotti|2022|p=83}}
=='''Pedagogical Approaches'''==
==='''Writing Styles'''===
Informal writing, such as some emailing, instant messaging, and texting, has crept into academic writing. In a study conducted by the Pew Internet & America Life Project, almost half of the respondents admitted to omitting proper punctuation and capitalization in their schoolwork. Others even used emoticons. Colleges and universities must now educate students on the different forms of written communication and when best to employ them.{{sfn|Carroll|2010|p=20}}


==Pedagogical Approaches==
==='''Multimedia Writing'''===
Barriers to teaching technical communications include the speed at which digital tools evolve and the complexity of software. {{sfn|Hovde|2017|pp=395-411}}
Best practices for tone, grammar, and style can vary depending on the form of media (auditory, visual, print, etc.), and many digital writings will combine two or more of these media formats. Students of technical writing may be taught specific techniques for different types of media to become proficient multimedia writers.{{sfn|Garrand|2006|p=23}} In their book ''Reading Images: The Grammar of Visual Design'', Gunther Kress and Theo van Leeuwen introduce the concept of visual grammar, which relates to multimodality that helps with complex ideas in visual grammar. Kress and van Leeuwen suggest that visual elements should follow a set of grammatical rules to construct visual designs.{{sfn|Kress|van Leeuwen|2020}}


Informal writing, such as some emailing, instant messaging, and texting, has crept into academic writing. In a study conducted by the Pew Internet & America Life Project, almost half of the respondents admitted to omitting proper punctuation and capitalization. Others even used emoticons. Colleges and universities now must focus on educating students on the different forms of written communication and when best to employ them.{{sfn|Carroll|2010|p=280}}
==='''Breaking and Building''' ===
Breaking and building is a method of teaching effective writing that can be applied to technical and digital formats. It asks students to curate collections of digital media by comparing and contrasting ("building") and to critically analyze these collections and attempt to reason out the decisions behind them ("breaking").{{sfn|Coco|Torres|2014|p=175}} Each process has a set of targeted learning outcomes. Learning outcomes for "building" include making and reflecting on choices to find, group, present, and compile digital content. Learning outcomes for "breaking" include identifying and critiquing decisions in curating existing digital content, such as where the content originated, how it is grouped, and how it is presented.{{sfn|Coco|Torres|2014|pp=178-179}}


==Future Trends and Challenges==
=='''Challenges and Ethical Considerations'''==
===Future Trends===
Between 2022 and 2032, the [https://en.wikipedia.org/wiki/Bureau_of_Labor_Statistics, United States Bureau of Labor Statistics] is projecting a 7% job growth for technical writers. {{sfn|United States Bureau of Labor Statistics|2023}}


===Challenges===
==='''Challenges'''===
Among others, a prominent barrier to technical writers is the dependency on input information accuracy. Outdated, incorrect, or inconsistent data delays the publication, requires more reparative efforts, and decreases productivity.{{sfn|Ajose-Coker|2022}} Also, Technical writers often have to contend with complex, outdated or unsuitable tools. This can make their job more difficult and time-consuming, and can lead to frustration and errors.{{sfn|Ajose-Coker|2022}}
Barriers to teaching technical communications include the speed at which digital tools evolve, the complexity of software,{{sfn|Hovde|Renguette|2017|pp=395-411}} and the dependency on input information accuracy. Outdated, incorrect, or inconsistent data delays the publication, requires more reparative efforts, and decreases productivity.{{sfn|Ajose-Coker|2022}} Also, technical writers often have to contend with complex, outdated or unsuitable tools. This can make their job more difficult and time-consuming, and can lead to frustration and errors.{{sfn|Ajose-Coker|2022}}


===Artificial Intelligence===
==='''Artificial Intelligence'''===
Artificial intelligence programs, utilizing natural language processing, are capable of producing technical writing and have advanced in recent years becoming more adept.{{sfn|Marr|2023}}
Artificial intelligence programs, utilizing natural language processing, are capable of producing technical writing and have advanced in recent years becoming more adept.{{sfn|Marr|2023}}
[[File:Chatgpt logo.jpg|thumb|297x297px|Logo for ChatGPT - an open AI that has rose in popularity.]]
One such program is [https://en.wikipedia.org/wiki/ChatGPT ChatGPT], which uses machine learning to produce texts with human-like style and tone.{{sfn|University of Central Arkansas|2023}} Another leader in this area, Contentbot, uses a WordPress plugin which gives blog writers ideas to enhance their posts which are shared via email.{{sfn|Siddiqui|2022}}


One such program is [https://en.wikipedia.org/wiki/ChatGPT ChatGPT], which uses machine learning to produce texts with human-like style and tone. {{sfn|University of Central Arkansas|2023}} Another leader in this area, Contentbot, uses a WordPress plugin which gives blog writers ideas to enhance their posts which are shared via email.{{sfn|Siddiqui|2022}}
==='''Plagiarism'''===
Because of the ability of chatbots to imitate human-like language, some education administrators have taken precautions to minimize the occurrence of students passing off artificially generated texts as their own. In some instances, educators have taken the view that material drawn from artificial intelligence software must be handled in the same way as sources from human authors.{{sfn|Klein|2023}} In such cases, students who incorporate artificially generated text into their work have been made to denote credit for the artificial intelligence program utilized.


===Plagiarism===
==='''Credit'''===
Because of the ability of chatbots to imitate human-like language, some education administrators have taken precautions to minimize the occurrence of students passing off artificially generated texts as their own. In some instances, educators have taken the view that material drawn from artificial intelligence software must be handled in the same way as sources from human authors. {{sfn|Klein|2023}} In such cases, students who incorporate artificially generated text into their work have been made to denote credit for the artificial intelligence program utilized.
The advent of chatbots has complicated the issue of credit where creative work is concerned. Because chatbots can simulate human speech, their ability to create cinematic dialogues and other types of creative writing have threatened the credits and financial condition of professional writers. According to an article by Aaron Mok and Jacob Zinkula on ''[https://www.businessinsider.com/ Business Insider]'', writing jobs are among the top 10 roles that AI is most likely to replace.{{sfn|Mok|2023}}


===Credit===
==='''Ethical Considerations''' ===
The advent of chatbots has complicated the issue of credit where creative work is concerned. Because chatbots can simulate human speech, their ability to create cinematic dialogues and other types of creative writing have threatened the credits and financial condition of professional writers. According to an article by Aaron Mok and Jacob Zinkula on ''[https://www.businessinsider.com/ Business Insider]'', writing jobs are among the top 10 roles that AI is most likely to replace. {{sfn|Mok|2023}}
Technical communicators:


==References==
* Observes laws, regulations, and fulfil contracts.
===Citations===
* Further the public good.
* Respect the confidentiality of clients.
* Produce quality products.
* Embrace fairness with respect to cultural diversity.
* Pursue professional self-improvement and education. <ref>[https://www.stc.org/about-stc/ethical-principles/]</ref>
 
The concept of ethics involves decision making based on value systems. Value systems are based on societal norms of acceptable behavior. Ethical dilemmas are decision opportunities in which value systems do not provide clear instruction for the appropriate course of action.{{sfn|Johnson-Sheehan|2018|pp=71}}
 
Technical communicators also have to be careful to avoid plagiarism, or taking ideas, thoughts, or words from someone else and passing them off as one's own.{{sfn|Carroll|2010|p=280}}
 
Technical communicators have to abide by ethical standards. The standards are divided into three primary categories. They are the employer, the public, and the environment.{{sfn|Markel|Selber|2019|pp=21-24}}
 
====The Employer====
Obligations to one's employer include competence and diligence, honesty and candor, confidentiality, and loyalty.{{sfn|Markel|Selber|2019|pp=21-24}} The technical communicator must adhere to these obligations so that he/she does not harm the reputation or operation of the employer.
 
Technical communicators may occasionally work for an organization with strict privacy policies that prohibit them from using the documents they create outside of the organization. It is important for ethical communicators to follow the privacy policy for their organization because unauthorized release of information could lead to consequences up to and including termination.{{sfn|Balzotti|2022|p=83}}
 
====The Public====
Organizations are obligated to treat customers fairly. Technical communicators must convey that the products or services an organization sells are safe and effective.{{sfn|Markel|Selber|2019|pp=21-24}}
 
====The Environment====
Technical communicators have an obligation to the environment. This obligation includes alerting their supervisors, managers, and executive leadership to products or processes that are detrimental to the environment. Protecting the environment can be costly, however, and organizations may consider ignoring legal guidelines to save money.{{sfn|Markel|Selber|2019|pp=21-24}} Yet, failure to adhere to U.S. Environmental Protection Agency regulations also has financial implications. For example, the penalty for mishandling hazardous waste is five years and/or up to $50,000 for each day of the violation.{{sfn|Environmental Protection Agency|2023}}
 
====Disinformation====
One primary ethical concern in all forms of writing, especially in digital writing, is the creation and spread of disinformation. Disinformation, often called "[[w:Fake news|fake news]]," is information that is purposefully spread as false or misleading and is a sub-type of misinformation.{{sfn|Lawrence|2022|loc=section 3.7}} Modern communication technologies allow the spread of information to occur quickly. Social media is one area where the spread of disinformation occurs regularly.
 
Some social media sites, such as Facebook, have begun to flag certain articles posted on the site as being questionable in their representation of facts or occurrences. Despite the widespread understanding and use of disinformation available today, digital writers need to be aware of their intent and the audience's needs and wants from their digital communication.{{sfn|Lucas|2023f}} Ethical considerations regarding citing sources, cross-referencing information, and using primary sources are good practices for maintaining ethical standing and credibility as a digital writer.
 
Technical writers should utilize gatekeepers to help mitigate the problem of disinformation. These individuals verify the accuracy of the information before it is distributed to primary readers. This helps protect the author from any ethical and legal issues.{{sfn|Balzotti|2022|p=83}}
 
=='''References''' ==
==='''Citations'''===
{{Reflist}}
{{Reflist}}


===Bibliography ===
===Bibliography===
{{Refbegin|30em}} <!--NOTE: You needn't use in your templates. Nor is the ISBN necessary.-->
{{Refbegin|30em}} <!--NOTE: You needn't use in your templates. Nor is the ISBN necessary.-->
* {{cite web |url=https://www.linkedin.com/advice/0/how-can-you-create-effective-visual-aids-1c |title=How Can You Create Effective Visual Aids for Technical Writing? |last=AI and the LinkedIn Community |date=2023 |website=www.linkedin.com |publisher=LinkedIn |access-date=2023-11-05 }}
* {{cite web |url=https://componize.com/common-problems-in-technical-writing-and-how-to-resolve-them/ |title=Common Problems in Technical Writing and How to Solve Them |last=Ajose-Coker |first=Dipo |date=2022 |website=componize.com |publisher=Componize Software |access-date=2023-11-19 }}
* {{cite web |url=https://componize.com/common-problems-in-technical-writing-and-how-to-resolve-them/ |title=Common Problems in Technical Writing and How to Solve Them |last=Ajose-Coker |first=Dipo |date=2022 |website=componize.com |publisher=Componize Software |access-date=2023-11-19 }}
* {{cite book |last=Balzotti |first=Jon|date=2022 |title=Technical Communication: A Design-Centric Approach |url= |location=New York |publisher=Routledge |page=83 }}
* {{cite book |last=Bair|first=Amy Lupold |date=2014 |title=Blogging for Dummies|url=|location=Hoboken, NJ |publisher=Jon Wiley & Sons, Inc|pages=|isbn=|author-link= }}
* {{cite book |last=Balzotti |first=Jon |date=2022 |title=Technical Communication: A Design-Centric Approach |edition= 2nd |url= |location=New York |publisher=Routledge |isbn=9780367438302 }}
* {{cite book |last=Barr |first=Chris |date=2010 |title=The Yahoo! Style Guide |url= |location=New York |publisher=St. Martin's }}
* {{cite book |last=Barr |first=Chris |date=2010 |title=The Yahoo! Style Guide |url= |location=New York |publisher=St. Martin's }}
*{{cite book |last=Bolter |first=Jay David |last2=Grusin |first2=Richard A. |date=1999 |title=Remediation: Understanding New Media |url=https://archive.org/details/remediationunder00bolt |location= Cambridge, MA |publisher= MIT Press |pages= 59|isbn= 9781491960202 |author-link= |ref=}}
* {{cite book |last=Carroll |first=Brian |date=2010 |title=Writing for Digital Media |url= |location=New York |publisher=Routledge }}
* {{cite book |last=Carroll |first=Brian |date=2010 |title=Writing for Digital Media |url= |location=New York |publisher=Routledge }}
* {{cite web |url=https://uca.edu/cetal/chat-gpt/ |title=Chat GPT: What is it? |last=University of Central Arkansas |first= |date= |website=uca.edu |publisher= University of Central Arkansas |access-date=2023-10-09 }}
* {{cite book |last1=Coco |first1=Pete |last2=Torres |first2=M. Gabriella |date=2014 |editor-last1=Dougherty |editor-first1=Jack |editor-last2=O'Donnell |editor-first2=Tennyson |title=<i>Web Writing: Why and How for Liberal Arts Teaching and Learning</i> |publisher=University of Michigan Press |pages=175-188 |chapter=“Writing as Curation: Using a ‘Building’ and ‘Breaking’ Pedagogy to Teach Culture in the Digital Age" |chapter-url=https://epress.trincoll.edu/webwriting/chapter/cocotorres }}
* {{cite web |url=https://www.betonconsultingeng.com/objectivity-in-technical-writing/#:~:text=Pointers%20for%20objective%20technical%20writing%201%20If%20you,5%20Remember%20that%20correlation%20is%20not%20causality.%20 |title=Objectivity in Technical Writing |last=Detwiler |first=Rachel |date=2021 |website=www.betonconsultingeng.com |publisher=Beton Consulting Engineers L.L.C. |access-date=2023-11-05 }}
* {{cite book |last=DeVoss |first=Danielle |last2=National Writing Project |last3=Eidman-Aadahl |first3=Elyse |last4=Hicks |first4=Troy |date=2010 |title=Because Digital Writing Matters: Improving Student Writing in Online and Multimedia Environments |location=San Francisco |publisher=Jossey-Bass |pages=105 |isbn= |url=https://openlibrary.org/books/OL34593323M/Because_Digital_Writing_Matters }}
* {{cite book |last=DeVoss |first=Danielle |last2=National Writing Project |last3=Eidman-Aadahl |first3=Elyse |last4=Hicks |first4=Troy |date=2010 |title=Because Digital Writing Matters: Improving Student Writing in Online and Multimedia Environments |location=San Francisco |publisher=Jossey-Bass |pages=105 |isbn= |url=https://openlibrary.org/books/OL34593323M/Because_Digital_Writing_Matters }}
* {{cite web |url=https://www.epa.gov/enforcement/criminal-provisions-resource-conservation-and-recovery-act-rcra |title=Criminal Provisions of the Resource Conservation and Recovery Act (RCRA) |date=2023 |publisher=United States Environmental Protection Agency }}
* {{cite web |url=https://hdl.handle.net/11299/168227 |title=Creating Technical Documentation for Digital Natives |last=Ellingson |first=Marissa |date=2014 |website=conservancy.umn.edu |publisher=University of Minnesota Digital Conservancy |access-date=2023-11-28 }}
*{{cite book |last=Enge |first=Eric |last2=Spencer |first2=Stephan |last3=Stricchiola |first3=Jessie |date=2022 |title=The Art of SEO: Mastering Search Engine Optimization |url=https://archive.org/details/artofseomasterin0000enge |location=Sebastopol, CA |publisher=O'Reilly |pages=9 }}
* {{cite web |url=https://www.epa.gov/enforcement/criminal-provisions-resource-conservation-and-recovery-act-rcra |last=Environmental Protection Agency |title=Criminal Provisions of the Resource Conservation and Recovery Act (RCRA) |date=2023 |publisher=United States Environmental Protection Agency }}
* {{cite web |url=https://technicalwriterhq.com/career/technical-writer/technical-writing-skills/ |title=Essential Technical Writing Skills |last=Fechter |first=Josh |date=2023 |website=technicalwriterhq.com |access-date=2023-11-21}}
* {{cite book |last=Gagich |first=Melanie |last2=Zickel |first2=Emilie |date=n.d. |title=Writing Arguments in Stem |chapter=Rhetorical Appeals: Logos, Pathos, and Ethos Defined |publisher=Digital Commons |url=https://digitalcommons.calpoly.edu/cgi/viewcontent.cgi?article=1000&context=oercoursematerials#page=44 |location= |pages=34-37 }}
* {{cite book |last=Gagich |first=Melanie |last2=Zickel |first2=Emilie |date=n.d. |title=Writing Arguments in Stem |chapter=Rhetorical Appeals: Logos, Pathos, and Ethos Defined |publisher=Digital Commons |url=https://digitalcommons.calpoly.edu/cgi/viewcontent.cgi?article=1000&context=oercoursematerials#page=44 |location= |pages=34-37 }}
* {{cite book |last=Garrand |first=Timothy |date=2006 |title=Writing for Multimedia and the Web: A Practical Guide to Content Development for Interactive Media |edition=3rd |location=Burlington, MA |publisher=Focal Press }}
* {{cite book |last=Garrett |first=Jesse James |title=The Elements of User Experience: User-Centered Design for the Web and Beyond |publisher=New Riders |edition=2nd |date=2011 |location=Berkeley, CA |page=17 }}  
* {{cite book |last=Garrett |first=Jesse James |title=The Elements of User Experience: User-Centered Design for the Web and Beyond |publisher=New Riders |edition=2nd |date=2011 |location=Berkeley, CA |page=17 }}  
* {{cite book |last=Godson |first=Williams|title=Web Design with HTML and CSS |p=37-41}}
* {{cite web |url=https://smashingmagazine.com/2014/08/a-closer-look-at-personas-part-2/ |title=A Closer Look at Personas: A Guide to Developing The Right Ones (Part 2) |last=Goltz | first=Shlomo |date=2014 |website=smashingmagazine.com |publisher=Smashing Media AG |access-date=2023-11-13 }}
* {{cite web |url=https://smashingmagazine.com/2014/08/a-closer-look-at-personas-part-2/ |title=A Closer Look at Personas: A Guide to Developing The Right Ones (Part 2) |last=Goltz | first=Shlomo |date=2014 |website=smashingmagazine.com |publisher=Smashing Media AG |access-date=2023-11-13 }}
* {{cite magazine |last=Grimstead |first=Deborah M. |date=1999 |title=Technical Writers are in Demand: Do You Have The Right Stuff? |magazine=Black Collegian |pages=128 }}   
* {{cite magazine |last=Grimstead |first=Deborah M. |date=1999 |title=Technical Writers are in Demand: Do You Have The Right Stuff? |magazine=Black Collegian |pages=128 }}
* {{cite book |last=Johnson-Sheehan |first=Richard |title=Technical Communication Today |url= |edition=6 |chapter=Chapter 4: Managing Ethical Challenges |location=Boston, MA |publisher=Pearson |date=2018 |pages=71-98 }}
* {{cite journal |last1=Hovde |first1=Marjorie |last2=Renguette |first2=Corinne |date=2017 |title=Technological Literacy: A Framework for Teaching Technical Communication Software Tools |journal=Technical Communication Quarterly |volume=26 |pages=395-411 |doi=10.1080/10572252.2017.1385998}}
* {{cite web |url=https://www.ibm.com/topics/knowledge-management |title=What is Knowledge Management? |first= |last=IBM |website=ibm.com |access-date=2023-11-24}}   
* {{cite web |url=https://www.idassoc.com/product-information-definition/data-sheet |title=Product Information Encyclopedia |last=Industrial Data Associates |first= |date=2020 |website=Industrial Data Associates |publisher= |access-date=2023-11-20 |quote= }}
* {{cite book |last=Johnson-Sheehan |first=Richard |title=Technical Communication Today |url= |edition=6 |location=Boston, MA |publisher=Pearson |date=2018 |pages= }}
* {{cite news |last=Klein |first=Alyson |date=2023 |title=ChatGPT Cheating: What to Do When It Happens |url=https://www.edweek.org/technology/chatgpt-cheating-what-to-do-when-it-happens/ |work=Education Week |location=Bethesda, MD |access-date=2023-11-05 }}
* {{cite news |last=Klein |first=Alyson |date=2023 |title=ChatGPT Cheating: What to Do When It Happens |url=https://www.edweek.org/technology/chatgpt-cheating-what-to-do-when-it-happens/ |work=Education Week |location=Bethesda, MD |access-date=2023-11-05 }}
* {{cite book |last=Kress |first=Gunther |last2=van Leeuwen |first2=Theo |date=2020 |title=Reading Images: The Grammar of Visual Design|url=|location=New York |publisher=Routledg|isbn=978-0415319157}}
* {{cite book |last=Krug |first=Steve |date=2014 |title=Don’t Make Me Think, Revisited|url= |location=Berkeley, CA |publisher=New Riders |pages= |isbn= |author-link= }}
* {{cite book |last=Krug |first=Steve |date=2014 |title=Don’t Make Me Think, Revisited|url= |location=Berkeley, CA |publisher=New Riders |pages= |isbn= |author-link= }}
* {{cite book |last=Lannon |first=John M. |last2=Gurak |first2=Laura J. |date=2020 |title=Technical Communication |edition=15 |url= |location= |publisher=Pearson Education |page= }}
* {{cite book |last=Lannon |first=John M. |last2=Gurak |first2=Laura J. |date=2020 |title=Technical Communication |edition=15 |url= |location= |publisher=Pearson Education |page= }}
Line 242: Line 429:
* {{cite web |url=https://grlucas.net/grl/Writing_on_a_Wiki |title=Writing on a Wiki |last=Lucas |first=Gerald| date=2021| website=grlucas.net| publisher=MediaWiki| access-date=2023-10-31 }}
* {{cite web |url=https://grlucas.net/grl/Writing_on_a_Wiki |title=Writing on a Wiki |last=Lucas |first=Gerald| date=2021| website=grlucas.net| publisher=MediaWiki| access-date=2023-10-31 }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Personas |title= Using Personas in Digital Writing
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Personas |title= Using Personas in Digital Writing
|last=Lucas |first=Gerald |date=2023a| website=grlucas.net |publisher=MediaWiki |access-date=2023-11-07 }}
|last=Lucas |first=Gerald |author-mask=1 |date=2023a| website=grlucas.net |publisher=MediaWiki |access-date=2023-11-07 }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/SEO |title=Search Engine Optimization: Strategies and Best Practices for Effective Online Visibility |last=Lucas |first=Gerald |date=2023b |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-19 }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/SEO |title=Search Engine Optimization: Strategies and Best Practices for Effective Online Visibility |last=Lucas |first=Gerald |author-mask=1 |date=2023b |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-19 }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Documents|title=Exploring the Dichotomy: A Comparative Analysis of Digital and Paper Documents |last=Lucas |first=Gerald |date=2023c |website=grlucas.net |publisher=MediaWiki |access-date=2023-10-29 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Documents|title=Exploring the Dichotomy: A Comparative Analysis of Digital and Paper Documents |last=Lucas |first=Gerald |author-mask=1 |date=2023c |website=grlucas.net |publisher=MediaWiki |access-date=2023-10-29 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Design/Users |title=User-Centered Design in Digital Documents |last=Lucas |first=Gerald |date=2023d |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-15 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Design/Users |title=User-Centered Design in Digital Documents |last=Lucas |first=Gerald |author-mask=1 |date=2023d |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-15 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Style |title=Audience-Centric Style in Digital Writing |last=Lucas |first=Gerald |date=2023e |website=grlucas.net |publisher=MediaWiki |access-date=2023-10-22 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Style |title=Audience-Centric Style in Digital Writing |last=Lucas |first=Gerald |author-mask=1 |date=2023e |website=grlucas.net |publisher=MediaWiki |access-date=2023-10-22 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Credibility |title=The Significance of Credibility in Digital Writing |last=Lucas |first=Gerald |author-mask=1 |date=2023f |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-21 }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Tech_Writing |title=Combining Disciplinary Approach to Technical Writing with Digital Writing: Enhancing Communication in the Digital Age |last=Lucas |first=Gerald |author-mask=1 |date=2023g |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-27 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Multimodal_Approach |title=Multimodal Approaches in Technical Writing |last=Lucas |first=Gerald |author-mask=1 |date=2023h |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-29 |quote= }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Accessibility |title=The Imperative of Accessibility in Digital Writing |last=Lucas |first=Gerald |author-mask=1 |date=2023i |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-29 }}
* {{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Scannability |title=Scannability |last=Lucas |first=Gerald |author-mask=1 |date=2023j |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-29 }}
*{{cite web |url=https://grlucas.net/grl/CompFAQ/Digital_Writing/Remediation|title=Remediation in Technical Writing: Bridging the Analog-Digital Divide |last=Lucas |first=Gerald |author-mask=1 |date=2023k |website=grlucas.net |publisher=MediaWiki |access-date=2023-11-30 }}
* {{cite web |url=https://www.indeed.com/career-advice/careers/what-does-a-technical-writer-do |title=What Does a Technical Writer Do? (Plus How To Become One) |last=Macari |first=Sabina |date=2023 |website=indeed.com |publisher=Indeed |access-date=2023-11-05 }}
* {{cite web |url=https://www.indeed.com/career-advice/careers/what-does-a-technical-writer-do |title=What Does a Technical Writer Do? (Plus How To Become One) |last=Macari |first=Sabina |date=2023 |website=indeed.com |publisher=Indeed |access-date=2023-11-05 }}
* {{cite magazine |last=Malone |first=Ed |date=2008 |title=Joseph D. Chapline: Technical Communication's Mozart |url=https://web.mst.edu/~malonee/chapline.pdf |magazine=<i>IEEE Professional Communication Society Newsletter</I> |access-date=2023-10-31 }}
* {{cite magazine |last=Malone |first=Ed |date=2008 |title=Joseph D. Chapline: Technical Communication's Mozart |url=https://web.mst.edu/~malonee/chapline.pdf |magazine=<i>IEEE Professional Communication Society Newsletter</I> |access-date=2023-10-31 }}
* {{cite journal |last=Malone |first=Edward |date=November 2011 |title=The First Wave (1953-1961) of the Professionalization Movement in Technical Communication |url=https://www.stc.org/techcomm/wp-content/uploads/sites/3/2016/08/november-2011-58-4.pdf |journal=Technical Communication |volume=58 |issue=4 |pages=285-306 |doi= |access-date=2023-10-11 }}
* {{cite journal |last=Malone |first=Edward |date=November 2011 |title=The First Wave (1953-1961) of the Professionalization Movement in Technical Communication |url=https://www.stc.org/techcomm/wp-content/uploads/sites/3/2016/08/november-2011-58-4.pdf |journal=Technical Communication |volume=58 |issue=4 |pages=285-306 |doi= |access-date=2023-10-11 }}
* {{cite book |last=Markel |first=Michael |title=Technical Communication |date=2009 |edition=9th |location=Boston |publisher=Bedford/St. Martin's |pages=22-25 }}
* {{cite book |last=Markel |first=Mike |last2=Selber |first2=Stuart A. |date=2019 |title=Practical Strategies of Technical Communication |edition=3rd |url= |location=Boston |publisher=Bedford/St. Martin’s |page= }}
* {{cite book |last=Markel |first=Mike |last2=Selber |first2=Stuart A. |date=2019 |title=Practical Strategies of Technical Communication |edition=3rd |url= |location=Boston |publisher=Bedford/St. Martin’s |page= }}
* {{cite web |url=https://www.forbes.com/sites/bernardmarr/2023/01/23/how-chatgpt-and-natural-language-technology-might-affect-your-job-if-you-are-a-computer-programmer/?sh=6d9acf79174b |title=How ChatGPT And Natural Language Technology Might Affect Your Job If You Are A Computer Programmer |last=Marr |first=Bernard |date=2023 |website=Forbes.com |publisher=Forbes Media |access-date=2023-10-31 |quote= }}
* {{cite web |url=https://www.forbes.com/sites/bernardmarr/2023/01/23/how-chatgpt-and-natural-language-technology-might-affect-your-job-if-you-are-a-computer-programmer/?sh=6d9acf79174b |title=How ChatGPT And Natural Language Technology Might Affect Your Job If You Are A Computer Programmer |last=Marr |first=Bernard |date=2023 |website=Forbes.com |publisher=Forbes Media |access-date=2023-10-31 |quote= }}
Line 257: Line 449:
* {{cite book| last=Parkinson |first=Mike |title=A Trainer’s Guide to PowerPoint: Best Practices for Master Presenters| location=United States| publisher=Association for Talent Development| chapter=Chapter 4. PowerPoint Tips, Tricks, and Secrets| date=2018 }}
* {{cite book| last=Parkinson |first=Mike |title=A Trainer’s Guide to PowerPoint: Best Practices for Master Presenters| location=United States| publisher=Association for Talent Development| chapter=Chapter 4. PowerPoint Tips, Tricks, and Secrets| date=2018 }}
* {{cite book |last=Perelman |first=Leslie |date=1998 |title=The Mayfield Handbook of Technical and Scientific Writing |url=https://www.mit.edu/course/21/21.guide/ |location=Mountain View |publisher=Mayfield Publishing Company |pages=n.p. |isbn= |author-link= }}
* {{cite book |last=Perelman |first=Leslie |date=1998 |title=The Mayfield Handbook of Technical and Scientific Writing |url=https://www.mit.edu/course/21/21.guide/ |location=Mountain View |publisher=Mayfield Publishing Company |pages=n.p. |isbn= |author-link= }}
* {{cite web |url=https://learn.g2.com/how-to-write-a-press-release |title=How to Write a Press Release That Catches People's Attention |date=2021 |last=Pradhan |first=Ninisha |website=learn.g2.com |publisher=G2.com |access-date=2023-11-21 }}
* {{cite web |url=https://proofed.com/writing-tips/a-beginners-guide-to-technical-writing/ |title=A Beginner’s Guide to Technical Writing |last=Proofed Editors |date=2020 |website=Proofed.com |publisher=Proofed |access-date=2023-11-05 }}
* {{cite journal |last=Rathbone |first=Robert |title=Growth of the technical writing profession |journal=STWE Review |volume=5 |issue=1 |date=1958 |pages=5-16 }}
* {{cite journal |last=Rathbone |first=Robert |title=Growth of the technical writing profession |journal=STWE Review |volume=5 |issue=1 |date=1958 |pages=5-16 }}
*{{cite book |last=Robbins |first=Jennifer Niederst |date=2018 |title=Learning Web Design: A Beginner’s Guide to HTML, CSS, JavaScript, and Web Graphics (5th ed.) |url= |location=Sebastopol, CA |publisher= O’Reilly Media, Inc. }}
*{{cite book |last=Robbins |first=Jennifer Niederst |date=2018 |title=Learning Web Design: A Beginner’s Guide to HTML, CSS, JavaScript, and Web Graphics (5th ed.) |url= |location=Sebastopol, CA |publisher= O’Reilly Media, Inc. }}
* {{cite book |last=Rose|first=Darren |last2=Garret |first2=Chris|date=2012 |title=ProBlogger: Secrets for Blogging Your Way to a Six-Figure Income|url=|location=Indianapolis, IN |publisher=Jon Wiley & Sons, Inc|pages=|isbn=|author-link= }}
* {{cite book |last1=Rosenfeld |first1=Louis |last2=Morville |first2=Peter |last3=Arango |first3=Jorge |date=2006 |title=Information Architecture for the Web and Beyond |edition=4th |location=Sebastopol, CA |publisher=O'Reilly Media, Inc.}}
* {{cite web |url=https://writingcooperative.com/intricacies-of-ai-tools-can-ai-tools-take-over-the-jobs-of-technical-writers-af36836f625c |last=Siddiqui |first=Zafar |title=Will Best Artificial Intelligence Take Over any Technical Content Writer? |date=2022 |website=writingcooperative.com |publisher=The Writing Cooperative |access-date=2023-11-19 }}
* {{cite web |url=https://writingcooperative.com/intricacies-of-ai-tools-can-ai-tools-take-over-the-jobs-of-technical-writers-af36836f625c |last=Siddiqui |first=Zafar |title=Will Best Artificial Intelligence Take Over any Technical Content Writer? |date=2022 |website=writingcooperative.com |publisher=The Writing Cooperative |access-date=2023-11-19 }}
* {{cite web |url=https://www.managementnote.com/features-of-technical-communication/#google_vignette |title=Features of Technical Communication |last=Smirti |date=2022 |website=managementnote.com |publisher=Management Note |access-date= 2023-11-05 }}
* {{cite web |url=https://www.managementnote.com/features-of-technical-communication/#google_vignette |title=Features of Technical Communication |last=Smirti |date=2022 |website=managementnote.com |publisher=Management Note |access-date= 2023-11-05 }}
* {{cite web |url=https://www.stc.org/about-stc/ |title=About STC |last=Society for Technical Communication |first= |date=2023a |website=stc.org |publisher= |access-date=2023-10-27 }}
* {{cite web |url=https://www.stc.org/about-stc/ethical-principles/ |title=Ethical Principles |last=Society for Technical Communication |first= |date=2023 |website=stc.org |publisher= |access-date=2023-10-27 }}
* {{cite web |url=https://www.stc.org/about-stc/ethical-principles/ |title=Ethical Principles |last=Society for Technical Communication |first= |date=2023b |website=stc.org |publisher= |access-date=2023-10-27 }}
* {{cite web |url=https://www.bls.gov/ooh/media-and-communication/technical-writers.htm#tab-6 |title=Occupational Outlook Handbook |last=United States Bureau of Labor Statistics |first= |date=2023 |website=bls.gov |publisher=United States Department of Labor |access-date=2023-11-07 }}
* {{cite web |url=https://www.bls.gov/ooh/media-and-communication/technical-writers.htm#tab-6 |title=Occupational Outlook Handbook |last=United States Bureau of Labor Statistics |first= |date=2023 |website=bls.gov |publisher=United States Department of Labor |access-date=2023-11-07 }}
* {{cite web |url=https://uca.edu/cetal/chat-gpt/ |title=Chat GPT: What is it? |last=University of Central Arkansas |first= |date= |website=uca.edu |publisher= University of Central Arkansas |access-date=2023-10-09 }}
* {{cite web |url=https://uca.edu/cetal/chat-gpt/ |title=Chat GPT: What is it? |last=University of Central Arkansas |first= |date=2023 |website=uca.edu |publisher= University of Central Arkansas |access-date=2023-10-09 }}
* {{cite web |url=https://www.viralnation.com/blog/what-is-digital-content-creation-and-how-can-it-help-me-as-a-marketing-manager/#:~:text=A%20rule%20of%20thumb%20in%20digital%20content%20creation,turn%2C%20share%20it%20with%20others%20in%20their%20network. |title=What is Digital Content Creation? (and How Can It Help Me as a Marketing Manager) |last=Viral Nation |date=2019 |website=viralnation.com |publisher= Viral Nation |access-date=2023-11-05 }}
* {{cite web |url=https://www.w3.org/WAI/fundamentals/accessibility-intro/|title=Introduction to Web Accessibility |last=WAI |first=|date=2022 |website=W3.org|publisher= |access-date= 2023-10-26 |quote= }}
* {{cite web |url=https://www.w3.org/WAI/fundamentals/accessibility-intro/|title=Introduction to Web Accessibility |last=WAI |first=|date=2022 |website=W3.org|publisher= |access-date= 2023-10-26 |quote= }}
* {{cite web |url=https://scribehow.com/library/user-guide |title=What is a User Guide? Everything You Need to Know |last=Wainaina |first=Timan |date=2022 |website= |publisher= |access-date=22 November 2023 |quote= }}
* {{cite web |url=https://wcag.com/legal/|title=Accessibility and the Law |last=WCAG |first= |date=2023 |website=wcag.com|publisher=eSSENTIAL Accessibility |access-date= 2023-10-26 |quote= }}
* {{cite web |url=https://wcag.com/legal/|title=Accessibility and the Law |last=WCAG |first= |date=2023 |website=wcag.com|publisher=eSSENTIAL Accessibility |access-date= 2023-10-26 |quote= }}
* {{cite web |url=https://owlcation.com/academia/Why-Research-is-Important-Within-and-Beyond-the-Academe|title=7 Reasons Why Research is Important |last=Zarah |first=Leann |date=2023 |website=Owlcation|access-date=2023-11-29}}
* {{cite book |last=Zeleznik |first=J. M. |last2=Burnett |first2=R. E. |last3=Benson |first3=P. J. |date=1999 |title=Technical Writing: What It Is and How to Do It |url= |location= |publisher=National Book Network |pages=107 |isbn= |author-link= }}
* {{cite book |last=Zeleznik |first=J. M. |last2=Burnett |first2=R. E. |last3=Benson |first3=P. J. |date=1999 |title=Technical Writing: What It Is and How to Do It |url= |location= |publisher=National Book Network |pages=107 |isbn= |author-link= }}
{{Refend}}




{{Refend}}


[[Category:Fall 2023]]
[[Category:Fall 2023]]
[[Category:ENGL 5106]]
[[Category:ENGL 5106]]

Latest revision as of 08:42, 2 December 2023

Book cover for "Digital Writing" by Dan Lawrence

Technical Writing in the Digital Age represents the dynamic and evolving discipline of creating written, visual, and interactive materials that convey complex information, instructions, and technical concepts in the context of contemporary digital technologies.

Technical writing is a specialized skill that requires technical knowledge and well-developed communication skills. It involves explaining complex information in a clear, concise, and accessible manner. Through the evolution of technologies like the Internet and smartphones, technical writing has evolved from traditional printed formats to more digital-oriented media. Today, users expect content to be available on various platforms and devices, providing up-to-date information on demand. Technical writers have adapted to these changes by creating compelling, concise, SEO-friendly content in various forms, such as infographics, e-books, podcasts, videos, blogs, GIFs, memes, and other interactive content.

Key factors include integrating multimedia elements, user-centered design principles, and ethical considerations like accessibility and inclusivity. This discipline also extends to collaborative writing processes and version control systems, acknowledging the necessity of teamwork in producing accurate and up-to-date technical documentation. Multimodality and the interfacing of multiple media platforms and sources also play a role in digital technical writing.

Overview

Goal of Technical Communication

Technical communication is a discipline utilized by various fields such as education, business, and science. In any domain, technical documentation shares a common objective: assisting the audience in achieving a task or goal.[1] This common objective is achieved by the technical writer communicating complex and technical information to the audience in a way that's easy to understand.[2]

Importance of Research

Research plays a vital role in technical writing. The main purposes of research are to inform action, gather evidence for theories, and contribute to developing knowledge in a field of study.[3] Research helps build knowledge and facilitate learning, helps society understand issues and increase public awareness, and aids in supporting truth.[3] Proper research provides a strong foundation for efficient technical writing.

Major decisions are often based upon results from research. Technical communicators often work with subject matter experts but can also conduct in-depth independent research to produce a technical document. The stages of critical thinking in the research process are[4]:

  • Asking the right questions. The right questions help define the research problem. The answers found in research are only as good as the questions asked.
  • Exploring a balance of views. This provides a broad range of evidence. Ask: What do informed sources say about the topic? On which points do sources agree or disagree? Which sources carry more weight than others?
  • Providing adequate depth into the topic through thorough research. Surface level is reached through popular media. The next level is reached through trade, business, and technical publications. The deepest level is reached through specialized literature such as peer-reviewed journals, government sources, and corporate documents.
  • Evaluating the findings. Search for bias in the research. Look for the accurate answer.
  • Interpreting the findings. Ensure the final report answers the original research problem.

The ability to adequately, accurately, and completely research a subject prior to writing technical communication dictates the writer's success.

History

Technical Writing Profession

Joseph D. Chapline

Joseph D. Chapline is considered to be one of the first technical writers, having written in 1949 the first-ever user manual for the Binary Automatic Computer (BINAC), an early personal computer.[5] In the 1950s, technical writing as a distinct profession began to take shape when technical writers founded formal organizations, academic programs, and conferences dedicated to the art. One of these key writing associations was the Association of Technical Writers and Editors, also formed in the 1950s. Several of these groups eventually merged, forming the Society for Technical Communication (STC) in 1960.[6] The STC is the world's oldest professional association dedicated to advancing the field of technical communication. The STC promotes adherence to a list of ethical principles. They are legality, honesty, confidentiality, quality, fairness, and professionalism.[7]

The need for paperwork ushered in by World War II served as the driving force for the technical writing profession in the United States.[8] This was years before the computer and photocopier became standard office equipment. During this period, the role of the technical writer revolved solely around words, and their primary work tools consisted of either a pencil or ink pen and paper. The technical writer would draft the document by hand, and a typist or clerical worker would then use a typewriter to transfer the writer's words into a finished document.[9]

Advances in technology thrust the technical writing profession into a new era. The technical writer's work may now include not only text but also images, drawings, and computer-based media. The modern technical writer may also be involved in research and information-gathering, speaking with subject matter experts, and selecting document media and project tools.[10]

The projects of today's technical writers range from writing instructions to assemble a living room chair to creating websites.[11] The titles of today's technical writers may vary as well, such as Information Architects or Documentation Specialists.[11]

Future Trends

Between 2022 and 2032, the United States Bureau of Labor Statistics is projecting a 7% job growth for technical writers.[2]

Job growth for tech writing projected by the Bureau of Labor Statistics

Technical Communication Strategies

Characteristics of Technical Communication

Technical communication is meant to guide an audience and must be easily understood. Successful technical documentation is accurate, logically sound, and appropriate.[12] Communication can be accurate in description and content. Accurate descriptions are easy to understand. Accurate content provides for the intended result. Communication delivered logically is well-organized, clear, and will be coherent for most users. Appropriate technical information contains elements and steps suitable for the intended purpose and audience.[12]

Standards Compliant

Many technical fields have industry-specific regulations and guidelines determined by governing bodies that impact their technical communication. Furthermore, many organizations may have a style guide that outlines preferred language usage, tone, and formatting.[13]

Detail-Oriented

Technical communication should be detail-oriented and free of errors and inconsistencies. Accurate information delivered with precision and specificity is essential for unambiguous and discrepancies-free communication.[13]

Objective

Objective communication is presented in an unbiased and impartial manner and is free of personal opinions. It relies upon facts and evidence and avoids an overly emotional tone. This approach is particularly important in fields where accuracy and impartiality are essential.[14]

Clear and Concise

Technical communication includes a well-structured document. Technical communication should be logically organized, straightforward, and easily understood by the target audience. Planning the document structure allows the technical writer to define the purpose, scope, and main points of the document. The language used should avoid needless jargon and be written in a manner that avoids redundant word usage and/or excessive explanations. [15][16]

Formatted and Organized

Technical documents should be formatted in a way that is consistent with the norms and standards of applicable professional fields. Additionally, formatting should adhere to guidelines that enhance usability. Information should be logically organized for easy reading comprehension. This may involve using headings, subheadings, bullet points, and numbered lists. Formatting details should remain consistent throughout the document.[13][15]

Graphical

Technical communication utilizes visuals strategically to facilitate understanding of textual content. Visuals such as diagrams, charts, graphs, or images can enhance understanding of a technical document. When presented properly, visuals can explain difficult concepts and make material accessible to a more diverse audience.[17]

Audience-specific

Technical communication should be customized to align with the knowledge and needs of its audience. Communication style and tone should be tailored to match the audience's level of expertise. Factors such as the users' technical background, familiarity with the subject, and specific requirements should be considered.[18] The tone sets the overall mood for the piece.

Document Design

Plan the structure of a document so that it is easy to follow and understand. Planning the document structure includes defining a purpose, breadth, and main subjects. Organize the document into a logical and clear order that maintains the purpose of the article. Headings, subheadings, and lists provide coherence to a technical paper. [19] The appropriateness of documents requires readers to understand the document's message quickly. The document should be of appropriate style and length for the readers' needs.

Examples of Technical Documents

Technical writing encompasses various genres and styles influenced by the information and discourse communities. Not all technical documents are produced by technical writers, as many professionals create various technical documents.[20]

Common types of technical communication include:[21]

Case Studies

Case studies are a form of empirical or observational research that consists of in-depth examination of distinct individuals, groups, events, or scenarios. This research can be used to generate qualitative or quantitative data.[22]

Data Sheets

A data sheet, also known as a technical datasheet, is a document used to describe and summarize the characteristics of a product, material, component, or technology.[23]

Descriptions

Descriptions are concise explanations of procedures and processes that assist readers in understanding how something works. Product descriptions and process descriptions are the two main types of technical descriptions.[24]

  • Product: provides detailed information about a specific item, including its features, specifications, and benefits.
  • Process: provides step-by-step instructions on how to perform a particular task or achieve a specific outcome.

Documentation

Documentation comprises various texts that allow users to accomplish tasks or gain information. It generally falls into three categories, which can be defined as follows:

  • Instructions: Text that describes how to complete a task, often offering numbered steps. Examples include how to download software or assemble a product.[25]
  • Specifications: Communications that deliver technical details on how a product is put together or a specific operation is executed. Also known as "specs," these texts may be written by engineers or technicians.[26]
  • Procedures and Protocols: Guidelines to ensure consistency, quality, and safety in the workplace. For example, a hospital may provide staff with procedures on how to adapt operations during an emergency, such as a power outage.[26]

Email

Image of an email

Emails are the primary form of communication in the workplace, used for both internal and external communication. They facilitate information exchange, idea exchange, and activity coordination.[27] Emails should be brief, concise, readable, and targeted to specific audiences with specific subject lines.[28]

Letters

Letters are a traditional form of communication most often used by employees to communicate with individuals outside of a company or organization. They are typically written on company letterhead. Today, letters are sent either by U.S. mail or electronically.[29]

Memos

A memo (short for memorandum) is an official communication, usually a message from the company, a manager or director, or another person or group acting in an official capacity, used to communicate with others within the same organization.[30]

Press Releases

A press release can be an organization's announcement or latest news distributed to media outlets with information for the public. A press release can be called a press statement, news release, or media release.[31]

Proposals

A proposal is a document that identifies an existing problem or opportunity and outlines a comprehensive strategy for addressing it. Organizations create internal proposals to describe programs and projects that meet specific operational needs, such as a plan to replace an outdated software system. Companies develop external proposals for potential customers or clients. These documents detail new products, services, or initiatives that a company will implement to address a specific customer concern.[32]

Reports

A report is a concise, easily understandable document that presents technical information in a clear, organized format, allowing readers to access varying levels of information. Reports are categorized as informal, such as briefs, and formal, such as research, scientific, and completion reports.[33]

Informal or Brief Reports

Informal or brief reports provide an objective overview of an organization's current state, past events, and future plans, ensuring that readers are well-informed about the organization's operations. Some examples include[34]:

  • Progress reports are used to inform management about the progress or status of a project.
  • White papers and briefings educate management or clients about important issues.
  • Incident reports objectively focus on presenting facts relating to an accident or irregular occurrence.
  • Laboratory reports describe experiments, tests, or inspections.
Formal Reports

A formal report is a factual and data-driven response to a research question.

  • Research reports present the findings of a study.
  • Scientific research reports outline the process, progress, and results of technical or scientific research or the current state of a research problem.
  • Completion reports assess the outcomes of a project or initiative and provide feedback to management or the client.

Resumes

Resumes offer an overview of an individual’s educational credentials and professional experience and often are used to demonstrate an applicant’s qualifications to potential employers.[35] They may be organized in various ways, but two common approaches are chronologically and by skills.

Chronological resumes demonstrate the sequence of education and employment history and detail a person’s tasks, responsibilities, and achievements in each successive role.

Skills resumes provide employment history, but the primary focus is to highlight how an individual applied distinct skills and experiences across various professional positions.[36]

User Guides

A user guide is an instructional manual created to help consumers use the product, service or system. A user guide typically includes step-by-step instructions.[37]

Digital Writing Strategies

Characteristics of Digital Documents

Electronic Format

Digital documents exist in electronic formats, which means they are stored and transmitted as binary data. This format allows for efficient storage, retrieval, and transmission of information via electronic devices.[38] Digital documentation is the only method to meet a critical challenge of the relatively new concept of "knowledge management" that applies to all organizations. A digital knowledge management system is crucial to an organization so everyone can access information created by employees who are no longer with the organization or to allow cross-referencing with other seemingly unrelated departments.[39]

Non-Tangible

Unlike paper documents, digital documents lack physical presence. They are intangible and exist as electronic files, residing on devices or in the cloud.[38]

Accessibility

Website content should be designed in accordance with Web Content Accessibility Guidelines (WCAG) to ensure that individuals with disabilities are able to access the same information as those without disabilities.[40] It is both ethically imperative and a legal requirement to include accessibility features in website design.[41]

There are four different types of impairment that can affect how a user interacts and perceives digital documents: vision, mobility, auditory, and cognitive.[42] Digital documents will need to be optimized so that information can be accessed by hardware and software tools used by people with disabilities.[43] Designing accessible digital content increases the technical writer's ability to engage with a broader audience base.[44]

Readability

From "Writing for the Web" by Lynda Felder: This pyramid explains how to best display information in a paragraph quickly for readability and scannability

Digital documents rely on the "Seven Cs" of precise writing to be effective and increase readability. Forms of technical writing must have readability. Readability is a term used to determine whether the content has clarity, conciseness, and courtesy.[45] The other four Cs are coherent, concrete, correct, and complete.[46]

Scannability

A document's scannability is determined by the ease in which it can be scanned to determine meaning. Readers often scan pages for words and phrases that align with their task or interests, as well as for trigger words that are deeply ingrained.[47] The most effective web content is concise and simple to scan, making it easy for users to find the important information. Breaking up text into interesting, easy-to-read sections helps users quickly find information.[48] Ways to improve a document's scannability include implementing visual elements, white space, concise language, highlighting, and emphasis.[49]

Ease of Reproduction and Distribution

Digital documents are easily copied and distributed. They can be duplicated without any loss of quality, making it simple to share information widely and at minimal cost.[38]

Hyperlinking

Hyperlinking is a quick and efficient method for directing readers to relevant information in digital documents, facilitating seamless navigation between sections, references, and external resources.[50] Hyperlinking also allows readers the opportunity to do further research by reading where the information originated.

Multimedia

Digital documents can incorporate multimedia elements like images, audio, video, and interactive content, enhancing engagement through visual and auditory elements. Multiple media formats work best when sharing new, complicated ideas.[51] Increasing multimodality on a website improves engagement, usability, and accessibility. This can improve the impact of the website's standings in search engine results pages (SERPs).[52]

Version Control

Version control is a characteristic of digital documents that allows for the tracking of edits and revisions to digital documents. In collaborative writing, version control helps maintain the document with accountability and transparency.[53]

Remote Collaboration

One form of collaborative technical writing is a wiki, a "website developed collaboratively by a community of users, allowing any user to add and edit content."[54] One of the predominant elements of a wiki is that it is defined as being open source. As a result, anyone can modify it regardless of their geographic location.

Security Measures

Digital documents can be protected with encryption, passwords, and access controls to safeguard sensitive information. These security measures enhance data protection and privacy.[38]

Environmental Impact

Digital documents have a smaller environmental footprint compared to paper documents, as they reduce the need for paper production, printing, and transportation.[38]

Dynamic Updates

Online digital documents can be updated dynamically, ensuring that users always have access to the most current information. This is particularly valuable in fast-changing fields.[38]

Global Accessibility

Digital documents can be shared globally, transcending geographical boundaries and time zones. They support international collaboration and the dissemination of knowledge on a global scale.[38]

Data Integration

In business and research settings, digital documents can integrate with databases and data analysis tools. This integration streamlines data collection, analysis, and reporting processes.[38]

Data Analytics

Digital documents can be subjected to data analytics techniques, allowing organizations to extract valuable insights from large volumes of textual data, which can inform decision-making and strategy.[38]

Examples of Digital Documents

Digital documentation is the conversion of physical documents into digital files, enabling easier access, retrieval, and sharing of information. It includes features like searchability, version control, and security measures to ensure data integrity and confidentiality.[38] In technical and professional writing, digital documentation takes various forms. These methods streamline the sharing of technical information, enhance collaboration, and ensure easy accessibility within professional settings, contributing to efficient communication and knowledge dissemination.[38]

Infographics

Infographics, shared as digital documents, typically combine text, graphics, and illustrations to convey complex concepts or data in a concise and visually appealing format. Infographics are often used to simplify information, making it more accessible to a broader audience, and are found in presentations, reports, websites, and educational materials.[55]

Presentations

Logo for Microsoft PowerPoint

Presentations created with PowerPoint or Google Slides are vital for professional communication and knowledge sharing. They condense complex information into visually appealing slides for effective presentations by using photos, videos, graphics, charts, and graphs.[56]

Blogs

A blog, short for "weblog," is an informational website organized into short articles called posts, typically a chronologically ordered series of website updates written and organized like a traditional diary.[57] They are regularly updated, providing readers with insights on a specific topic or subject. Blogs serve various purposes, including sharing opinions, providing news, offering educational content, and documenting personal experiences.[58]

Forums

Forums are an example of a digital document that allows users to seek and provide information within a community. Forums are gathering information points users provide instead of technical writers. Companies can utilize forums as part of their technical communication with consumers in the digital environment, expanding past the traditional technical communication of a user manual.[59]

Personas in Digital Writing

Personas in the context of digital writing, which is writing composed, created, and read in digital environments, refer to semi-fictional characters that encapsulate the characteristics, behaviors, and needs of target audience segments. They align closely with the principles of user-centered design (UCD).[60] There are myriad ways to integrate user-centered thinking into the creative process of user experience (UX) design, and personas are one of the most effective ways to empathize with and analyze users.[61]

Personas may guide the creation of documentation and tutorials catering to different user needs. It is crucial to adjust the language and tone to match the persona's preference. Different personas can influence and guide the design of the project.

Along with adjusting tone and language to suit the desired user, personas can be used to ensure the purposed digital document properly informs the reader with the correct and accurate information the user seeks.

Rhetoric

Rhetoric is a communication strategy whose primary goal is to persuade an audience. It is grounded in three foundational concepts first defined by the Greek philosopher Aristotle. These concepts are logos, which engages with the reader’s sense of logic or reason; pathos, which appeals to the reader’s emotions; and ethos, which addresses the audience’s values and the writer’s credibility. Within this framework, writers utilize specific techniques or devices to influence and engage readers. Examples include appealing to an audience’s sense of logic by using factual examples to support a point or evoking emotion through descriptive visual language.[62]

In today’s digital age, writers can use digital technologies as rhetorical devices to influence the reader. Electronic images and informational graphics can be incorporated into digital and online documents to illustrate or reinforce points made in the text.[63] Hyperlinks can provide access to additional information that supports authors’ ideas and enhances their credibility.[64] Nevertheless, the writer's basic task of informing and persuading an audience is the same in digital communication as in other forms of writing.[65]

Digital writers must therefore consider specific elements that compose the rhetorical context in which texts are created and delivered. Such elements may include evaluating the demographics, habits, and needs of an intended audience; determining the overall objective of the communications; and deciding what technologies will be used to create the content. Together, this analysis allows writers to craft messages that both appeal to and inform the target audience. In the digital age, such rhetorical messages may be conveyed through websites, social media, and other digital platforms.[66]

Tools for Digital Technology

With the rise of digital technology, technical writing has had to adapt to the needs of a digital era. Technical writers can use various tools to author and present their documents.

Content Management Systems (CMS)

A content management system (CMS) is a software application that allows users to create, manage, and modify digital content on a website. It provides a user-friendly interface and tools to easily organize, publish, and update content, including text, images, videos, and documents. Additionally, CMSs often offer features like user permissions, version control, and Search Engine Optimization (SEO) to enhance the overall website management experience.[67] Some popular examples of CMS include WordPress, Wix, and Blogger.

Image Processing Software

Image processing software plays a valuable role in technical and digital writing by facilitating the creation and enhancement of visuals. Documentation and tutorials help optimize images to convey processes or procedures effectively. Whether for screen captures illustrating software interfaces, data visualizations, or graphics for digital content, image processing tools contribute to creating clear and visually appealing materials.[68] These tools, such as Adobe and Canva, enhance the visual impact of technical and digital writing, ensuring that images are optimized, informative, and engaging for the audience.

Word Processors

The logos of popular word processors: (L-R Clockwise) Apple Pages, Google Docs, SharePoint, Microsoft Word.

Word processors are software applications designed for creating, editing, and formatting documents on a computer. They provide many features, such as spell-checking, checking grammar, and inserting images and tables. These programs are typically used for writing essays, creating reports, or drafting professional documents.[69] Some popular software applications are Microsoft Word, Google Docs, SharePoint, and Apple Pages. These programs allow documents to be readily disseminated. Comment capability enables audience members to interact about a document with one another and the author.

Text Editors

Text editors are fundamental technical and digital writing tools, offering a platform for creating and manipulating plain text files. They are indispensable for programming tasks, providing syntax highlighting and code folding features. Text editors are commonly used to write code, markup languages (HTML, XML, Markdown), and edit configuration files.[70] Notable examples include Notepad (Windows), TextEdit (macOS), and Notepad++. Whether for programmers, writers, or system administrators, text editors play a crucial role in content creation and technical work.

Search Engine Optimization (SEO)

SEO refers to the practice of optimizing online content to enhance its visibility and ranking on search engine results pages (SERPs), making it a crucial skill for digital writers.[71] To optimize content for SEO means to have the goal of SEO in mind at the time of designing, creating, and writing a web page for publication. Using keywords and alt text are two examples of optimizing content for SEO.[72]

Keywords

Keywords are the words that search engines scan a website for and index as the page's most important words. Based on other pages using the same keywords, the website is added to the search engine results pages from best matches to worst matches. The position of a website in search results is influenced by where it ranks on a scale determined by the keywords that a user searches for.[71] To optimize a website's keywords, you should begin with researching keywords on your own website and ensure that you have an XML sitemap so search engines such as Google can scan your web pages for updated information. In addition to using keywords, updating a page's metadata information can also help with showing up on SERPs. Using title and header tags as well as meta descriptions for content also helps optimize a website's ratings in SERPs.[71]

Alt Text

Alt text (alternative text), or alt attributes, is a practice that increases the usability and accessibility of a web page for users. Alt text is often used for visual elements that cannot be displayed in a different format but still provides description of the element for screen readers or users that may have a disability. Alt text also improves a website's SEO as a form of content optimization.[71]

Social Media Presence

Facebook Logo

Sharing content from a website across different social media platforms is another way to create SEO optimization. This technique can help with being seen as legitimate and improves the visibility of the website overall. Additionally, it can drive traffic and enable backlinking, where other websites can link to the website.[71]

Goals of Searching: The User's Perspective

A user of search engines formulates queries by using keywords or posing questions. One of the most important elements of building an SEO strategy for a website is developing a thorough understanding of the psychology of your target audience and how they use words and concepts to obtain information about the services and/or products you provide. Once you understand how the average search engine user—and, more specifically, your target audience—utilizes query-based search engines, you can more effectively reach and keep those users.[73]

User Experience

User experience (UX) is how a product works and is experienced from the user's perspective.[74] By creating a positive user experience, technical writers can ensure the intended message is effectively communicated and retained. UX design methods include user-centered design, information architecture, responsive design, multimodality, and usability.

User-Centered Design

User-centered design (UCD) is implemented by considering the user and their needs throughout the entire development of a product.[75] The approach of UCD in technical writing consists of the following methodologies:[76]

  • User Research: the act of conducting thorough research through surveys, interviews, and usability testing to gain a better understanding of user needs and experiences when using a digital document
  • Ideation and prototyping: the process of creating digital designs and prototypes to assist with exploring possible solutions to meet user needs
  • Usability testing: the act of having users interact with digital document designs and then adjusting the design based on user feedback
  • Implementation: the stage in which the design is implemented after adjusting from prior testing
  • Evaluation: the stage in which the digital document is assessed to ensure that it is meeting user needs
  • Maintenance and updates: to maintain a digital document based on user feedback and changing needs

Information Architecture

To ensure a digital document has effective UX design and accessible information, technical writers must construct a clear and organized information architecture (IA). IA is a design principle that organizes information so that it is easily found and understood by users, prioritizing their needs and reducing information overload. A design challenge is making IA understood across multiple digital experiences, changing the navigation structure to fit different media while staying logical and consistent for the user.[77] IA that is not constructed well can confuse the user and could cause them to give up their search of information in frustration.[78]

The architecture components of IA can be divided into four different categories:[79]

  • Organization systems: how information is categorized and organized for user understanding
  • Labeling systems: how information is represented
  • Navigation systems: how users browse information and navigate between pages
  • Searching systems: how users search for specific information

Responsive Design

Responsive design is a strategy that appropriately updates the layout and content of a website or document in relation to the screen size, device, and/or orientation, allowing the site or document to be easily viewed and navigated regardless of the device used. With the increased use of mobile devices, web content should be constructed with proper responsive web design (RWD) to ensure effective UX and usability on those devices.[80]

There are several design strategies that can be implemented that will increase the success of RWD:[81]

  • Fluid layout: Responsive sites can be constructed using a fluid layout (or flexible grid) system that will allow content to adjust and flow according to the available screen space.
  • Flexible and responsive images: Images and other embedded media can be instructed to fit their containers instead of remaining at a fixed size. Images with varying resolutions can also be swapped according to screen size to avoid high-resolution images on smaller devices.
  • CSS media queries: Media queries can be written into the CSS (Cascading Style Sheet), instructing the site's construction according to screen width and orientation. Adding breakpoints for several screen sizes allows pages to be designed for specific devices.
  • Content hierarchy: Carefully constructing content that is organized for the user and creating a hierarchy of content that prioritizes user needs is necessary to ensure effective user experience and navigation across multiple screen sizes.[82]

Multimodality

While responsive design focuses on the system or interface response to user inputs, multimodality refers to integrating multiple modes of communication to evaluate how effective communication can be in the digital age.[83]

There are essential elements to multimodality that improve the UX experience for readers in digital documents:

  • Accessibility: Documents that contain multimodal, or multimedia elements, allow for diversity in obtaining information to cater to diverse learning styles and abilities. For example, a slideshow presentation that contains audio will help aid those with visual impairments.
  • Engagement: Combining static information with visuals, such as images, videos, or interactive modules, can create a more engaging experience for readers in the digital age.
  • Clarity and Comprehension: Jargon-heavy text and complex ideas are able to be showcased in charts, diagrams, and infographics that are easily able to clarify concepts better than text.
  • Persuasion: Combining the elements listed above may allow for the creators to influence their audience.

Usability

Technical writers must create documents and websites that meet the expectations of their readers and users. In doing so, writers increase the usability of their site or document.[84] Usability consultant Steve Krug considers the most important rule for ensuring a site or document is usable is by making pages self-evident and allowing the user not to have to think about actions.[85] A website that is well designed for usability means that the users will not have any questions about the content or functions of the site. The site will have a clear hierarchy, use standard web design principles, have well-defined content areas, include noticeable and simple links, and limited distractions.[86]

A document or website written for usability can be easily scanned by using the following concepts:[87]

  • Highlighting keywords
  • Writing descriptive headings and subheadings
  • Incorporating bulleted list
  • Constructing shorter paragraphs
  • Implementing an inverted pyramid writing style by beginning with the most important information
  • Decreasing the word count of traditional writing
  • Using clear and concise language and, when appropriate, visual aids

Remediation

Remediation is the process through which new media forms borrow elements from older media forms and transform and re-contextualize them. As media evolves, so do the ways users can consume it. When first introduced, remediation was described as a type of reformation, such as taking a paper letter and turning it into an email.[88] Today, remediation of a digital document often adds to the user experience by enhancing the document. An example of remediation is making a document more accessible by adding a text-to-speech feature for users with poor vision or adding a tutorial to an electronic manual.

This can be simplified into two key principals:

  • Immediacy and Hypermediacy: Immediacy refers to the desire to transcend a medium, while hypermediacy takes the medium and infuses it through the new medium.[89][90]
  • Transparent and Opaque Media: Transparent media allows the content to take center stage, while opaque media makes users aware of the medium's presence.[89][90]

Overall, remediation is necessary to create a multimodal document in the digital age.

Pedagogical Approaches

Writing Styles

Informal writing, such as some emailing, instant messaging, and texting, has crept into academic writing. In a study conducted by the Pew Internet & America Life Project, almost half of the respondents admitted to omitting proper punctuation and capitalization in their schoolwork. Others even used emoticons. Colleges and universities must now educate students on the different forms of written communication and when best to employ them.[91]

Multimedia Writing

Best practices for tone, grammar, and style can vary depending on the form of media (auditory, visual, print, etc.), and many digital writings will combine two or more of these media formats. Students of technical writing may be taught specific techniques for different types of media to become proficient multimedia writers.[92] In their book Reading Images: The Grammar of Visual Design, Gunther Kress and Theo van Leeuwen introduce the concept of visual grammar, which relates to multimodality that helps with complex ideas in visual grammar. Kress and van Leeuwen suggest that visual elements should follow a set of grammatical rules to construct visual designs.[93]

Breaking and Building

Breaking and building is a method of teaching effective writing that can be applied to technical and digital formats. It asks students to curate collections of digital media by comparing and contrasting ("building") and to critically analyze these collections and attempt to reason out the decisions behind them ("breaking").[94] Each process has a set of targeted learning outcomes. Learning outcomes for "building" include making and reflecting on choices to find, group, present, and compile digital content. Learning outcomes for "breaking" include identifying and critiquing decisions in curating existing digital content, such as where the content originated, how it is grouped, and how it is presented.[95]

Challenges and Ethical Considerations

Challenges

Barriers to teaching technical communications include the speed at which digital tools evolve, the complexity of software,[96] and the dependency on input information accuracy. Outdated, incorrect, or inconsistent data delays the publication, requires more reparative efforts, and decreases productivity.[97] Also, technical writers often have to contend with complex, outdated or unsuitable tools. This can make their job more difficult and time-consuming, and can lead to frustration and errors.[97]

Artificial Intelligence

Artificial intelligence programs, utilizing natural language processing, are capable of producing technical writing and have advanced in recent years becoming more adept.[98]

Logo for ChatGPT - an open AI that has rose in popularity.

One such program is ChatGPT, which uses machine learning to produce texts with human-like style and tone.[99] Another leader in this area, Contentbot, uses a WordPress plugin which gives blog writers ideas to enhance their posts which are shared via email.[100]

Plagiarism

Because of the ability of chatbots to imitate human-like language, some education administrators have taken precautions to minimize the occurrence of students passing off artificially generated texts as their own. In some instances, educators have taken the view that material drawn from artificial intelligence software must be handled in the same way as sources from human authors.[101] In such cases, students who incorporate artificially generated text into their work have been made to denote credit for the artificial intelligence program utilized.

Credit

The advent of chatbots has complicated the issue of credit where creative work is concerned. Because chatbots can simulate human speech, their ability to create cinematic dialogues and other types of creative writing have threatened the credits and financial condition of professional writers. According to an article by Aaron Mok and Jacob Zinkula on Business Insider, writing jobs are among the top 10 roles that AI is most likely to replace.[102]

Ethical Considerations

Technical communicators:

  • Observes laws, regulations, and fulfil contracts.
  • Further the public good.
  • Respect the confidentiality of clients.
  • Produce quality products.
  • Embrace fairness with respect to cultural diversity.
  • Pursue professional self-improvement and education. [103]

The concept of ethics involves decision making based on value systems. Value systems are based on societal norms of acceptable behavior. Ethical dilemmas are decision opportunities in which value systems do not provide clear instruction for the appropriate course of action.[104]

Technical communicators also have to be careful to avoid plagiarism, or taking ideas, thoughts, or words from someone else and passing them off as one's own.[52]

Technical communicators have to abide by ethical standards. The standards are divided into three primary categories. They are the employer, the public, and the environment.[105]

The Employer

Obligations to one's employer include competence and diligence, honesty and candor, confidentiality, and loyalty.[105] The technical communicator must adhere to these obligations so that he/she does not harm the reputation or operation of the employer.

Technical communicators may occasionally work for an organization with strict privacy policies that prohibit them from using the documents they create outside of the organization. It is important for ethical communicators to follow the privacy policy for their organization because unauthorized release of information could lead to consequences up to and including termination.[106]

The Public

Organizations are obligated to treat customers fairly. Technical communicators must convey that the products or services an organization sells are safe and effective.[105]

The Environment

Technical communicators have an obligation to the environment. This obligation includes alerting their supervisors, managers, and executive leadership to products or processes that are detrimental to the environment. Protecting the environment can be costly, however, and organizations may consider ignoring legal guidelines to save money.[105] Yet, failure to adhere to U.S. Environmental Protection Agency regulations also has financial implications. For example, the penalty for mishandling hazardous waste is five years and/or up to $50,000 for each day of the violation.[107]

Disinformation

One primary ethical concern in all forms of writing, especially in digital writing, is the creation and spread of disinformation. Disinformation, often called "fake news," is information that is purposefully spread as false or misleading and is a sub-type of misinformation.[108] Modern communication technologies allow the spread of information to occur quickly. Social media is one area where the spread of disinformation occurs regularly.

Some social media sites, such as Facebook, have begun to flag certain articles posted on the site as being questionable in their representation of facts or occurrences. Despite the widespread understanding and use of disinformation available today, digital writers need to be aware of their intent and the audience's needs and wants from their digital communication.[109] Ethical considerations regarding citing sources, cross-referencing information, and using primary sources are good practices for maintaining ethical standing and credibility as a digital writer.

Technical writers should utilize gatekeepers to help mitigate the problem of disinformation. These individuals verify the accuracy of the information before it is distributed to primary readers. This helps protect the author from any ethical and legal issues.[106]

References

Citations

  1. ↑ Markel & Selber 2019.
  2. ↑ 2.0 2.1 United States Bureau of Labor Statistics 2023.
  3. ↑ 3.0 3.1 Zarah 2023.
  4. ↑ Lannon & Gurak 2020, p. 145.
  5. ↑ Malone 2008.
  6. ↑ Malone 2011, pp. 285-306.
  7. ↑ Society for Technical Communication 2023.
  8. ↑ Rathbone 1958.
  9. ↑ Rathbone 1958, p. 6.
  10. ↑ Macari 2023.
  11. ↑ 11.0 11.1 Grimstead 1999.
  12. ↑ 12.0 12.1 Perelman 1998.
  13. ↑ 13.0 13.1 13.2 Smirti 2022.
  14. ↑ Detwiler 2021.
  15. ↑ 15.0 15.1 Proofed Editors 2020.
  16. ↑ [1]
  17. ↑ AI and the LinkedIn Community 2023.
  18. ↑ Viral Nation 2019.
  19. ↑ [2]
  20. ↑ Lannon & Gurak 2020, p. 32.
  21. ↑ Mussack 2021.
  22. ↑ Johnson-Sheehan 2018, pp. 401-404.
  23. ↑ Industrial Data Associates 2020.
  24. ↑ Lannon & Gurak 2020, pp. 443-453.
  25. ↑ Balzotti 2022, p. 167.
  26. ↑ 26.0 26.1 Johnson-Sheehan 2018, p. 205.
  27. ↑ Lannon & Gurak 2020, p. 335.
  28. ↑ Lannon & Gurak 2020, p. 348.
  29. ↑ Johnson-Sheehan 2018, p. 139.
  30. ↑ Lannon & Gurak 2020, p. 353.
  31. ↑ Pradhan 2021.
  32. ↑ Johnson-Sheehan 2018, p. 245.
  33. ↑ Johnson-Sheehan 2018, chpt 10 & 11.
  34. ↑ Johnson-Sheehan 2018, pp. 285-288.
  35. ↑ Johnson-Sheehan 2018, p. 100.
  36. ↑ Markel & Selber 2019, pp. 411-412.
  37. ↑ Wainaina 2022.
  38. ↑ 38.00 38.01 38.02 38.03 38.04 38.05 38.06 38.07 38.08 38.09 38.10 Lucas 2023c.
  39. ↑ IBM.
  40. ↑ WAI 2022.
  41. ↑ WCAG 2023.
  42. ↑ Robbins 2018, p. 42.
  43. ↑ Barr 2010, pp. 103-104.
  44. ↑ Lucas 2023i.
  45. ↑ Zeleznik, Burnett & Benson 1999, p. 207.
  46. ↑ Last 2019.
  47. ↑ Krug 2014, p. 23.
  48. ↑ Barr 2010, p. 103.
  49. ↑ Lucas 2023j.
  50. ↑ Carroll 2010, p. 79.
  51. ↑ Carroll 2010, p. 36.
  52. ↑ 52.0 52.1 Carroll 2010, p. 280.
  53. ↑ Lucas 2023d.
  54. ↑ Lucas 2021.
  55. ↑ Lannon & Gurak 2020, pp. 292-293.
  56. ↑ Parkinson 2018, chpt. 4.
  57. ↑ Bair 2014, p. 7.
  58. ↑ Rose & Garret 2012, p. 2.
  59. ↑ Ellingson 2014.
  60. ↑ Lucas 2023a.
  61. ↑ Goltz 2014.
  62. ↑ Gagich & Zickel n.d., pp. 34-37.
  63. ↑ Markel & Selber 2019, pp. 182-186.
  64. ↑ Lucas 2023g.
  65. ↑ DeVoss et al. 2010, p. 105.
  66. ↑ Lawrence 2022, pp. 6-14.
  67. ↑ Carroll 2010, p. 129.
  68. ↑ Robbins 2018, p. 664.
  69. ↑ Carroll 2010, p. 229.
  70. ↑ Godson, p. 37-41.
  71. ↑ 71.0 71.1 71.2 71.3 71.4 Lucas 2023b.
  72. ↑ Barr 2010, chpt. 17.
  73. ↑ Enge, Spencer & Stricchiola 2022, p. 9.
  74. ↑ Garrett 2011, p. 6.
  75. ↑ Garrett 2011, p. 17.
  76. ↑ Lucas 2023e.
  77. ↑ Rosenfeld, Morville & Arango 2006, pp. 1, 17-18.
  78. ↑ Garrand 2006, p. 12.
  79. ↑ Rosenfeld, Morville & Arango 2006, p. 90.
  80. ↑ Robbins 2018, p. 485.
  81. ↑ Robbins 2018, p. 487.
  82. ↑ Robbins 2018, p. 499.
  83. ↑ Lucas 2023h.
  84. ↑ Garrand 2006, p. 26.
  85. ↑ Krug 2014, pp. 11-18.
  86. ↑ Carroll 2010, p. 69.
  87. ↑ Garrand 2006, pp. 25-26.
  88. ↑ Bolter & Grusin 1999, p. 59.
  89. ↑ 89.0 89.1 Bolter & Grusin 1999, p. 53.
  90. ↑ 90.0 90.1 Lucas 2023k.
  91. ↑ Carroll 2010, p. 20.
  92. ↑ Garrand 2006, p. 23.
  93. ↑ Kress & van Leeuwen 2020.
  94. ↑ Coco & Torres 2014, p. 175.
  95. ↑ Coco & Torres 2014, pp. 178-179.
  96. ↑ Hovde & Renguette 2017, pp. 395-411.
  97. ↑ 97.0 97.1 Ajose-Coker 2022.
  98. ↑ Marr 2023.
  99. ↑ University of Central Arkansas 2023.
  100. ↑ Siddiqui 2022.
  101. ↑ Klein 2023.
  102. ↑ Mok 2023.
  103. ↑ [3]
  104. ↑ Johnson-Sheehan 2018, pp. 71.
  105. ↑ 105.0 105.1 105.2 105.3 Markel & Selber 2019, pp. 21-24.
  106. ↑ 106.0 106.1 Balzotti 2022, p. 83.
  107. ↑ Environmental Protection Agency 2023.
  108. ↑ Lawrence 2022, section 3.7.
  109. ↑ Lucas 2023f.

Bibliography


Retrieved from "https://litwiki.org/index.php?title=Technical_Writing_in_the_Digital_Age&oldid=19796"