Assignment Prompt & Instructions
see attachment
– 2 years ago
**files (2)**
– ## WEmoduleasig1Module1.docx
– ## WEModule1.classdocx.docx
**## WEmoduleasig1Module1.docx**
**Module 1:** _Introduction to Technical Writing_
In this module, you read about the six principles in the code of ethics as defined by STC (Legality, Honesty, Confidentiality, Quality, Fairness, and Professionalism). Select one of the principles and explain why this principle is important in your own words. Describe with at least one example what would happen if a technical piece did not follow that principle.
If you are new to Canvas, follow
[these directionsLinks to an external site.](https://community.canvaslms.com/t5/Student-Guide/How-do-I-submit-an-online-assignment/ta-p/503) for submitting your assignments and to review the
[academic expectations](https://agmu.instructure.com/courses/1876/pages/expectations-and-best-practices-for-assignments) for your submission. To review your grades and comments from your professor after it is graded, follow
[these instructionsLinks to an external site.](https://community.canvaslms.com/t5/Student-Guide/How-do-I-view-assignment-comments-from-my-instructor/ta-p/283).
**Submission Instructions**
· Your reflection should include an opening paragraph, content, and a concluding paragraph (at least three paragraphs).
· You must present your writing double-spaced, in a Times New Roman, Arial, or Courier New font, with a font size of 12.
· Pay attention to grammar rules (spelling and syntax).
· Your work must be original and not contain material copied from books or the internet.
· When citing the work of other authors, including citations and references, use APA 7 style to respect their intellectual property and avoid plagiarism.
· Remember that your writing must have a header or a cover page that includes the name of the institution, the program, the course code, the title of the activity, your name and student number, and the assignment's due date.
· Review the rubric to determine how your assignment will be graded.
· Your assignment will be run through Turnitin to check for plagiarism. Please check your results, make any necessary corrections, and resubmit a revised copy if the system identifies issues. If you are new to Turnitin,
[review the information](https://agmu.instructure.com/courses/1876/pages/using-turnitin) in the Student Resource Center about it.
· Submit your assignment by 11:59 p.m. ET on Sunday.
**## WEModule1.classdocx.docx**
**Module 1:** _Introduction to Technical Writing_
**Characteristics of Technical Writing**
Several authors (Alred, 2019; Markel, 2012; Pfeiffer, 2002) defined the characteristics of Technical Writing as:
·
**Purpose**: Explaining how to complete a task or process (Putting together a bed frame, completing a project, applying for college)
·
**Knowledge of the topic**: The writer knows more than the audience. Assume no prior knowledge.
·
**Audience**: Several people of different backgrounds (Take the example of putting together a crib for the nursery. The person who purchases and is putting it together maybe a crafty mom, a dad who only deals with computers but is not so crafty with his hands, or an engineer. All of them might purchase the same crib.)
·
**Criteria for evaluation**: Ideas need to be clear and organized. Simple to read.
·
**Statistical and graphic support**: Explains existing conditions and presents alternatives based on data.
·
**Ethical**: We have the legal obligation to be truthful in our technical writing. The steps need to be correct to avoid someone being hurt. Take the crib example above. If one of the steps of adding a particular screw is missed and the crib breaks when you lay down the baby, it could cost the baby's life and have legal ramifications for the manufacturer.
Let's look at a poem and how it is written in technical terms. Below is Robert Frost's "The Road not Taken." On the first column, you will see each of the poem's verses, and on the second column, how it would be written in technical communications.
| | |
| — | — |
| Comparison between Literacy and Technical writing |
| **Literary Writing** | **Technical Writing** |
| Two roads diverged in a yellow wood,<br>And sorry I could not travel both<br>And be one traveler, long I stood<br>And looked down one as far as I could<br>To where it bent in the undergrowth; | There are two roads. <br>You have to select one. <br>You looked as far as you could see. |
| Then took the other, as just as fair,<br>And having perhaps the better claim,<br>Because it was grassy and wanted wear;<br>Though as for that the passing there<br>Had worn them really about the same, | You decided to take the one that had more grass. |
| And both that morning equally lay<br>In leaves, no step had trodden black.<br>Oh, I kept the first for another day!<br>Yet knowing how way leads on to way,<br>I doubted if I should ever come back. | Once you decide on one road, you can't go back to the other. |
| I shall be telling this with a sigh<br>Somewhere ages and ages hence:<br>Two roads diverged in a wood, and I—<br>I took the one less traveled by,<br>And that has made all the difference. | You took the grassier road. |
Let's read about the Code of Ethics that must be followed when writing a technical piece.
**Code of Ethics in Technical Writing**
The Society for Technical Communication (STC) enumerates six ethical principles of technical communications. These are:
1. Legality
2. Honesty
3. Confidentiality
4. Quality
5. Fairness
6. Professionalism
Visit the Society for Technical Communication (STC) site to read about the ethical principles:
[Ethical PrinciplesLinks to an external site.](https://www.stc.org/about-stc/ethical-principles/).
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from https://www.stc.org/about-stc/ethical-principles/
**References**
Alred, G. J. (2019).
_The handbook of technical writing_(12th ed.). Bedford/Saint Martin's.
Annemarie, H. R. D. (2015).
_Technical writing_.
[https://coccoer.pressbooks.com/Links to an external site.](https://coccoer.pressbooks.com/)
Azusa Pacific Writing Center. (2018, December 18)
_What is Technical Writing?_ Youtube https://www.youtube.com/watch?v=9SB4tfD0hxM
Hamlin, A., Rubio, C., & DeSilva, M. (2015).
_Ethics in Technical Writing – Technical Writing._ [https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/Links to an external site.](https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/)
Markel, M. (2012).
_Technical Communication_ (10th ed.). St Martin's Press.
Pfeiffer, W. S. (2002).
_Technical writing: A practical approach_ (5th ed.). Pearson.
Race, C. (n.d.).
_Chapter 1: Introduction to Technical Writing_. Open Technical Communication. Retrieved January 11, 2022, from
[https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961Links to an external site.](https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961)
Society for Technical Communication. (2021, September 21)
_Defining Technical Communication._ [https://www.stc.org/about-stc/defining-technical-communication/Links to an external site.](https://www.stc.org/about-stc/defining-technical-communication/)
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from
[https://www.stc.org/about-stc/ethical-principles/Links to an external site.](https://www.stc.org/about-stc/ethical-principles/)
L. M. Surhone, M. T. Timpledon, & S. F. Marseken, Eds. (2021).
_Defining Technical Communication_. STC. Betascript Publishing.
**Module 1:** _Introduction to Technical Writing_
**Introduction**
Imagine explaining the use of PowerPoint and all its functions to someone who has never worked with the program in a written manual. Where would you start? For describing how to open the program, perhaps, followed by how to create new presentations, add images, or select font? How would you make sure that the student understands everything? For example, with the help of bullet points (step by step), screenshots, or images, for example?
This is a simple example of the questions that a technical writer has to deal with on a day-to-day basis. And not just technical writers, but anyone involved in writing documentation for (complex) technical processes such as reports, processes, or manuals. Technical writing means writing in a way that whoever your target audience is capable of understanding it – regardless of their background or background knowledge. But why is it so important? And what are the best practices when it comes to technical writing? During this course, you will have the opportunity to examine the different types of technical writing genres, compare and contrast with varying writing styles, and try a hand at writing your own in the form of a white paper.
**Defining Technical Writing**
Type in "Technical Writing" in Google, and you may find many definitions of technical writing or technical communications. The Society for Technical Communication (STC) is the world's oldest specialized association devoted to developing technical communication. They define Technical Communication as a broad field that exhibits particular characteristics:
· Communicating
_about technical or specialized topics_, such as computer applications, medical procedures, or environmental regulations.
· Communicating
_using technology_, such as web pages, help files, or social media sites.
· Providing
_instructions about how to do something_, regardless of how technical the task is or even if technology is used to create or distribute that communication (STC, 2021)
In other words, technical writing makes the information accessible to those who need the information. Imagine putting together an IKEA bed without instructions. Where would you begin? Technical Writing also advances the company's goals: for you to come back and purchase other products. If you had a bad experience and found yourself without instructions, would you even go back to the store and get more products from them? Probably not.
You have probably written many essays in school, dabbled in creative storytelling, or even wrote a poem. When you enter the job market, these aren't the types of writing you will encounter or need to produce. Usually, you will be asked to write about how to complete a task, or you will have to read about how a specific software works. These are all examples of Technical Writing. Here are some differences between technical writing and literary writing:
| | |
| — | — |
| Comparison of Technical and Literary Writing |
| **Technical Writing** | **Literary Writing** |
| Use of denotative (explicit) language | Vocabulary more focused on subjectivity is mainly reflected in the use of figures of language. |
| Prevalence serves as a respectful function based on concrete data | Use of the functions: poetic, metalinguistic, and emotional, marked by the subjective spirit of the writer. |
| Objectivity | Use of subjectivity and with a more personal tone. |
| Discourse purpose aims to inform and clarify | Objective focused on entertainment. |
| Fairness and accuracy | Attachment to aesthetic aspects of language. Speech wrapped in a diversity of interpretations. |
| Precise vocabulary | |
Gerson (n.d.) presents the continuum of communication from subjective to objective, from literary creative work to technical writing:
[Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762?wrap=1) [Download Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762/download?download_frd=1)
Gerson, S. M. (n.d.).
_Writing that Works: A Teacher's Guide to Technical Writing_. Kansas Curriculum Center Washburn University.
[https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.htmlLinks to an external site.](https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.html)
**## WEModule1.classdocx.docx**
**Module 1:** _Introduction to Technical Writing_
**Characteristics of Technical Writing**
Several authors (Alred, 2019; Markel, 2012; Pfeiffer, 2002) defined the characteristics of Technical Writing as:
·
**Purpose**: Explaining how to complete a task or process (Putting together a bed frame, completing a project, applying for college)
·
**Knowledge of the topic**: The writer knows more than the audience. Assume no prior knowledge.
·
**Audience**: Several people of different backgrounds (Take the example of putting together a crib for the nursery. The person who purchases and is putting it together maybe a crafty mom, a dad who only deals with computers but is not so crafty with his hands, or an engineer. All of them might purchase the same crib.)
·
**Criteria for evaluation**: Ideas need to be clear and organized. Simple to read.
·
**Statistical and graphic support**: Explains existing conditions and presents alternatives based on data.
·
**Ethical**: We have the legal obligation to be truthful in our technical writing. The steps need to be correct to avoid someone being hurt. Take the crib example above. If one of the steps of adding a particular screw is missed and the crib breaks when you lay down the baby, it could cost the baby's life and have legal ramifications for the manufacturer.
Let's look at a poem and how it is written in technical terms. Below is Robert Frost's "The Road not Taken." On the first column, you will see each of the poem's verses, and on the second column, how it would be written in technical communications.
| | |
| — | — |
| Comparison between Literacy and Technical writing |
| **Literary Writing** | **Technical Writing** |
| Two roads diverged in a yellow wood,<br>And sorry I could not travel both<br>And be one traveler, long I stood<br>And looked down one as far as I could<br>To where it bent in the undergrowth; | There are two roads. <br>You have to select one. <br>You looked as far as you could see. |
| Then took the other, as just as fair,<br>And having perhaps the better claim,<br>Because it was grassy and wanted wear;<br>Though as for that the passing there<br>Had worn them really about the same, | You decided to take the one that had more grass. |
| And both that morning equally lay<br>In leaves, no step had trodden black.<br>Oh, I kept the first for another day!<br>Yet knowing how way leads on to way,<br>I doubted if I should ever come back. | Once you decide on one road, you can't go back to the other. |
| I shall be telling this with a sigh<br>Somewhere ages and ages hence:<br>Two roads diverged in a wood, and I—<br>I took the one less traveled by,<br>And that has made all the difference. | You took the grassier road. |
Let's read about the Code of Ethics that must be followed when writing a technical piece.
**Code of Ethics in Technical Writing**
The Society for Technical Communication (STC) enumerates six ethical principles of technical communications. These are:
1. Legality
2. Honesty
3. Confidentiality
4. Quality
5. Fairness
6. Professionalism
Visit the Society for Technical Communication (STC) site to read about the ethical principles:
[Ethical PrinciplesLinks to an external site.](https://www.stc.org/about-stc/ethical-principles/).
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from https://www.stc.org/about-stc/ethical-principles/
**References**
Alred, G. J. (2019).
_The handbook of technical writing_(12th ed.). Bedford/Saint Martin's.
Annemarie, H. R. D. (2015).
_Technical writing_.
[https://coccoer.pressbooks.com/Links to an external site.](https://coccoer.pressbooks.com/)
Azusa Pacific Writing Center. (2018, December 18)
_What is Technical Writing?_ Youtube https://www.youtube.com/watch?v=9SB4tfD0hxM
Hamlin, A., Rubio, C., & DeSilva, M. (2015).
_Ethics in Technical Writing – Technical Writing._ [https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/Links to an external site.](https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/)
Markel, M. (2012).
_Technical Communication_ (10th ed.). St Martin's Press.
Pfeiffer, W. S. (2002).
_Technical writing: A practical approach_ (5th ed.). Pearson.
Race, C. (n.d.).
_Chapter 1: Introduction to Technical Writing_. Open Technical Communication. Retrieved January 11, 2022, from
[https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961Links to an external site.](https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961)
Society for Technical Communication. (2021, September 21)
_Defining Technical Communication._ [https://www.stc.org/about-stc/defining-technical-communication/Links to an external site.](https://www.stc.org/about-stc/defining-technical-communication/)
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from
[https://www.stc.org/about-stc/ethical-principles/Links to an external site.](https://www.stc.org/about-stc/ethical-principles/)
L. M. Surhone, M. T. Timpledon, & S. F. Marseken, Eds. (2021).
_Defining Technical Communication_. STC. Betascript Publishing.
**Module 1:** _Introduction to Technical Writing_
**Introduction**
Imagine explaining the use of PowerPoint and all its functions to someone who has never worked with the program in a written manual. Where would you start? For describing how to open the program, perhaps, followed by how to create new presentations, add images, or select font? How would you make sure that the student understands everything? For example, with the help of bullet points (step by step), screenshots, or images, for example?
This is a simple example of the questions that a technical writer has to deal with on a day-to-day basis. And not just technical writers, but anyone involved in writing documentation for (complex) technical processes such as reports, processes, or manuals. Technical writing means writing in a way that whoever your target audience is capable of understanding it – regardless of their background or background knowledge. But why is it so important? And what are the best practices when it comes to technical writing? During this course, you will have the opportunity to examine the different types of technical writing genres, compare and contrast with varying writing styles, and try a hand at writing your own in the form of a white paper.
**Defining Technical Writing**
Type in "Technical Writing" in Google, and you may find many definitions of technical writing or technical communications. The Society for Technical Communication (STC) is the world's oldest specialized association devoted to developing technical communication. They define Technical Communication as a broad field that exhibits particular characteristics:
· Communicating
_about technical or specialized topics_, such as computer applications, medical procedures, or environmental regulations.
· Communicating
_using technology_, such as web pages, help files, or social media sites.
· Providing
_instructions about how to do something_, regardless of how technical the task is or even if technology is used to create or distribute that communication (STC, 2021)
In other words, technical writing makes the information accessible to those who need the information. Imagine putting together an IKEA bed without instructions. Where would you begin? Technical Writing also advances the company's goals: for you to come back and purchase other products. If you had a bad experience and found yourself without instructions, would you even go back to the store and get more products from them? Probably not.
You have probably written many essays in school, dabbled in creative storytelling, or even wrote a poem. When you enter the job market, these aren't the types of writing you will encounter or need to produce. Usually, you will be asked to write about how to complete a task, or you will have to read about how a specific software works. These are all examples of Technical Writing. Here are some differences between technical writing and literary writing:
| | |
| — | — |
| Comparison of Technical and Literary Writing |
| **Technical Writing** | **Literary Writing** |
| Use of denotative (explicit) language | Vocabulary more focused on subjectivity is mainly reflected in the use of figures of language. |
| Prevalence serves as a respectful function based on concrete data | Use of the functions: poetic, metalinguistic, and emotional, marked by the subjective spirit of the writer. |
| Objectivity | Use of subjectivity and with a more personal tone. |
| Discourse purpose aims to inform and clarify | Objective focused on entertainment. |
| Fairness and accuracy | Attachment to aesthetic aspects of language. Speech wrapped in a diversity of interpretations. |
| Precise vocabulary | |
Gerson (n.d.) presents the continuum of communication from subjective to objective, from literary creative work to technical writing:
[Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762?wrap=1) [Download Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762/download?download_frd=1)
Gerson, S. M. (n.d.).
_Writing that Works: A Teacher's Guide to Technical Writing_. Kansas Curriculum Center Washburn University.
[https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.htmlLinks to an external site.](https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.html)
**## WEmoduleasig1Module1.docx**
**Module 1:** _Introduction to Technical Writing_
In this module, you read about the six principles in the code of ethics as defined by STC (Legality, Honesty, Confidentiality, Quality, Fairness, and Professionalism). Select one of the principles and explain why this principle is important in your own words. Describe with at least one example what would happen if a technical piece did not follow that principle.
If you are new to Canvas, follow
[these directionsLinks to an external site.](https://community.canvaslms.com/t5/Student-Guide/How-do-I-submit-an-online-assignment/ta-p/503) for submitting your assignments and to review the
[academic expectations](https://agmu.instructure.com/courses/1876/pages/expectations-and-best-practices-for-assignments) for your submission. To review your grades and comments from your professor after it is graded, follow
[these instructionsLinks to an external site.](https://community.canvaslms.com/t5/Student-Guide/How-do-I-view-assignment-comments-from-my-instructor/ta-p/283).
**Submission Instructions**
· Your reflection should include an opening paragraph, content, and a concluding paragraph (at least three paragraphs).
· You must present your writing double-spaced, in a Times New Roman, Arial, or Courier New font, with a font size of 12.
· Pay attention to grammar rules (spelling and syntax).
· Your work must be original and not contain material copied from books or the internet.
· When citing the work of other authors, including citations and references, use APA 7 style to respect their intellectual property and avoid plagiarism.
· Remember that your writing must have a header or a cover page that includes the name of the institution, the program, the course code, the title of the activity, your name and student number, and the assignment's due date.
· Review the rubric to determine how your assignment will be graded.
· Your assignment will be run through Turnitin to check for plagiarism. Please check your results, make any necessary corrections, and resubmit a revised copy if the system identifies issues. If you are new to Turnitin,
[review the information](https://agmu.instructure.com/courses/1876/pages/using-turnitin) in the Student Resource Center about it.
· Submit your assignment by 11:59 p.m. ET on Sunday.
**## WEModule1.classdocx.docx**
**Module 1:** _Introduction to Technical Writing_
**Characteristics of Technical Writing**
Several authors (Alred, 2019; Markel, 2012; Pfeiffer, 2002) defined the characteristics of Technical Writing as:
·
**Purpose**: Explaining how to complete a task or process (Putting together a bed frame, completing a project, applying for college)
·
**Knowledge of the topic**: The writer knows more than the audience. Assume no prior knowledge.
·
**Audience**: Several people of different backgrounds (Take the example of putting together a crib for the nursery. The person who purchases and is putting it together maybe a crafty mom, a dad who only deals with computers but is not so crafty with his hands, or an engineer. All of them might purchase the same crib.)
·
**Criteria for evaluation**: Ideas need to be clear and organized. Simple to read.
·
**Statistical and graphic support**: Explains existing conditions and presents alternatives based on data.
·
**Ethical**: We have the legal obligation to be truthful in our technical writing. The steps need to be correct to avoid someone being hurt. Take the crib example above. If one of the steps of adding a particular screw is missed and the crib breaks when you lay down the baby, it could cost the baby's life and have legal ramifications for the manufacturer.
Let's look at a poem and how it is written in technical terms. Below is Robert Frost's "The Road not Taken." On the first column, you will see each of the poem's verses, and on the second column, how it would be written in technical communications.
| | |
| — | — |
| Comparison between Literacy and Technical writing |
| **Literary Writing** | **Technical Writing** |
| Two roads diverged in a yellow wood,<br>And sorry I could not travel both<br>And be one traveler, long I stood<br>And looked down one as far as I could<br>To where it bent in the undergrowth; | There are two roads. <br>You have to select one. <br>You looked as far as you could see. |
| Then took the other, as just as fair,<br>And having perhaps the better claim,<br>Because it was grassy and wanted wear;<br>Though as for that the passing there<br>Had worn them really about the same, | You decided to take the one that had more grass. |
| And both that morning equally lay<br>In leaves, no step had trodden black.<br>Oh, I kept the first for another day!<br>Yet knowing how way leads on to way,<br>I doubted if I should ever come back. | Once you decide on one road, you can't go back to the other. |
| I shall be telling this with a sigh<br>Somewhere ages and ages hence:<br>Two roads diverged in a wood, and I—<br>I took the one less traveled by,<br>And that has made all the difference. | You took the grassier road. |
Let's read about the Code of Ethics that must be followed when writing a technical piece.
**Code of Ethics in Technical Writing**
The Society for Technical Communication (STC) enumerates six ethical principles of technical communications. These are:
1. Legality
2. Honesty
3. Confidentiality
4. Quality
5. Fairness
6. Professionalism
Visit the Society for Technical Communication (STC) site to read about the ethical principles:
[Ethical PrinciplesLinks to an external site.](https://www.stc.org/about-stc/ethical-principles/).
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from https://www.stc.org/about-stc/ethical-principles/
**References**
Alred, G. J. (2019).
_The handbook of technical writing_(12th ed.). Bedford/Saint Martin's.
Annemarie, H. R. D. (2015).
_Technical writing_.
[https://coccoer.pressbooks.com/Links to an external site.](https://coccoer.pressbooks.com/)
Azusa Pacific Writing Center. (2018, December 18)
_What is Technical Writing?_ Youtube https://www.youtube.com/watch?v=9SB4tfD0hxM
Hamlin, A., Rubio, C., & DeSilva, M. (2015).
_Ethics in Technical Writing – Technical Writing._ [https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/Links to an external site.](https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/)
Markel, M. (2012).
_Technical Communication_ (10th ed.). St Martin's Press.
Pfeiffer, W. S. (2002).
_Technical writing: A practical approach_ (5th ed.). Pearson.
Race, C. (n.d.).
_Chapter 1: Introduction to Technical Writing_. Open Technical Communication. Retrieved January 11, 2022, from
[https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961Links to an external site.](https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961)
Society for Technical Communication. (2021, September 21)
_Defining Technical Communication._ [https://www.stc.org/about-stc/defining-technical-communication/Links to an external site.](https://www.stc.org/about-stc/defining-technical-communication/)
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from
[https://www.stc.org/about-stc/ethical-principles/Links to an external site.](https://www.stc.org/about-stc/ethical-principles/)
L. M. Surhone, M. T. Timpledon, & S. F. Marseken, Eds. (2021).
_Defining Technical Communication_. STC. Betascript Publishing.
**Module 1:** _Introduction to Technical Writing_
**Introduction**
Imagine explaining the use of PowerPoint and all its functions to someone who has never worked with the program in a written manual. Where would you start? For describing how to open the program, perhaps, followed by how to create new presentations, add images, or select font? How would you make sure that the student understands everything? For example, with the help of bullet points (step by step), screenshots, or images, for example?
This is a simple example of the questions that a technical writer has to deal with on a day-to-day basis. And not just technical writers, but anyone involved in writing documentation for (complex) technical processes such as reports, processes, or manuals. Technical writing means writing in a way that whoever your target audience is capable of understanding it – regardless of their background or background knowledge. But why is it so important? And what are the best practices when it comes to technical writing? During this course, you will have the opportunity to examine the different types of technical writing genres, compare and contrast with varying writing styles, and try a hand at writing your own in the form of a white paper.
**Defining Technical Writing**
Type in "Technical Writing" in Google, and you may find many definitions of technical writing or technical communications. The Society for Technical Communication (STC) is the world's oldest specialized association devoted to developing technical communication. They define Technical Communication as a broad field that exhibits particular characteristics:
· Communicating
_about technical or specialized topics_, such as computer applications, medical procedures, or environmental regulations.
· Communicating
_using technology_, such as web pages, help files, or social media sites.
· Providing
_instructions about how to do something_, regardless of how technical the task is or even if technology is used to create or distribute that communication (STC, 2021)
In other words, technical writing makes the information accessible to those who need the information. Imagine putting together an IKEA bed without instructions. Where would you begin? Technical Writing also advances the company's goals: for you to come back and purchase other products. If you had a bad experience and found yourself without instructions, would you even go back to the store and get more products from them? Probably not.
You have probably written many essays in school, dabbled in creative storytelling, or even wrote a poem. When you enter the job market, these aren't the types of writing you will encounter or need to produce. Usually, you will be asked to write about how to complete a task, or you will have to read about how a specific software works. These are all examples of Technical Writing. Here are some differences between technical writing and literary writing:
| | |
| — | — |
| Comparison of Technical and Literary Writing |
| **Technical Writing** | **Literary Writing** |
| Use of denotative (explicit) language | Vocabulary more focused on subjectivity is mainly reflected in the use of figures of language. |
| Prevalence serves as a respectful function based on concrete data | Use of the functions: poetic, metalinguistic, and emotional, marked by the subjective spirit of the writer. |
| Objectivity | Use of subjectivity and with a more personal tone. |
| Discourse purpose aims to inform and clarify | Objective focused on entertainment. |
| Fairness and accuracy | Attachment to aesthetic aspects of language. Speech wrapped in a diversity of interpretations. |
| Precise vocabulary | |
Gerson (n.d.) presents the continuum of communication from subjective to objective, from literary creative work to technical writing:
[Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762?wrap=1) [Download Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762/download?download_frd=1)
Gerson, S. M. (n.d.).
_Writing that Works: A Teacher's Guide to Technical Writing_. Kansas Curriculum Center Washburn University.
[https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.htmlLinks to an external site.](https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.html)
**## WEmoduleasig1Module1.docx**
**Module 1:** _Introduction to Technical Writing_
In this module, you read about the six principles in the code of ethics as defined by STC (Legality, Honesty, Confidentiality, Quality, Fairness, and Professionalism). Select one of the principles and explain why this principle is important in your own words. Describe with at least one example what would happen if a technical piece did not follow that principle.
If you are new to Canvas, follow
[these directionsLinks to an external site.](https://community.canvaslms.com/t5/Student-Guide/How-do-I-submit-an-online-assignment/ta-p/503) for submitting your assignments and to review the
[academic expectations](https://agmu.instructure.com/courses/1876/pages/expectations-and-best-practices-for-assignments) for your submission. To review your grades and comments from your professor after it is graded, follow
[these instructionsLinks to an external site.](https://community.canvaslms.com/t5/Student-Guide/How-do-I-view-assignment-comments-from-my-instructor/ta-p/283).
**Submission Instructions**
· Your reflection should include an opening paragraph, content, and a concluding paragraph (at least three paragraphs).
· You must present your writing double-spaced, in a Times New Roman, Arial, or Courier New font, with a font size of 12.
· Pay attention to grammar rules (spelling and syntax).
· Your work must be original and not contain material copied from books or the internet.
· When citing the work of other authors, including citations and references, use APA 7 style to respect their intellectual property and avoid plagiarism.
· Remember that your writing must have a header or a cover page that includes the name of the institution, the program, the course code, the title of the activity, your name and student number, and the assignment's due date.
· Review the rubric to determine how your assignment will be graded.
· Your assignment will be run through Turnitin to check for plagiarism. Please check your results, make any necessary corrections, and resubmit a revised copy if the system identifies issues. If you are new to Turnitin,
[review the information](https://agmu.instructure.com/courses/1876/pages/using-turnitin) in the Student Resource Center about it.
· Submit your assignment by 11:59 p.m. ET on Sunday.
**## WEModule1.classdocx.docx**
**Module 1:** _Introduction to Technical Writing_
**Characteristics of Technical Writing**
Several authors (Alred, 2019; Markel, 2012; Pfeiffer, 2002) defined the characteristics of Technical Writing as:
·
**Purpose**: Explaining how to complete a task or process (Putting together a bed frame, completing a project, applying for college)
·
**Knowledge of the topic**: The writer knows more than the audience. Assume no prior knowledge.
·
**Audience**: Several people of different backgrounds (Take the example of putting together a crib for the nursery. The person who purchases and is putting it together maybe a crafty mom, a dad who only deals with computers but is not so crafty with his hands, or an engineer. All of them might purchase the same crib.)
·
**Criteria for evaluation**: Ideas need to be clear and organized. Simple to read.
·
**Statistical and graphic support**: Explains existing conditions and presents alternatives based on data.
·
**Ethical**: We have the legal obligation to be truthful in our technical writing. The steps need to be correct to avoid someone being hurt. Take the crib example above. If one of the steps of adding a particular screw is missed and the crib breaks when you lay down the baby, it could cost the baby's life and have legal ramifications for the manufacturer.
Let's look at a poem and how it is written in technical terms. Below is Robert Frost's "The Road not Taken." On the first column, you will see each of the poem's verses, and on the second column, how it would be written in technical communications.
| | |
| — | — |
| Comparison between Literacy and Technical writing |
| **Literary Writing** | **Technical Writing** |
| Two roads diverged in a yellow wood,<br>And sorry I could not travel both<br>And be one traveler, long I stood<br>And looked down one as far as I could<br>To where it bent in the undergrowth; | There are two roads. <br>You have to select one. <br>You looked as far as you could see. |
| Then took the other, as just as fair,<br>And having perhaps the better claim,<br>Because it was grassy and wanted wear;<br>Though as for that the passing there<br>Had worn them really about the same, | You decided to take the one that had more grass. |
| And both that morning equally lay<br>In leaves, no step had trodden black.<br>Oh, I kept the first for another day!<br>Yet knowing how way leads on to way,<br>I doubted if I should ever come back. | Once you decide on one road, you can't go back to the other. |
| I shall be telling this with a sigh<br>Somewhere ages and ages hence:<br>Two roads diverged in a wood, and I—<br>I took the one less traveled by,<br>And that has made all the difference. | You took the grassier road. |
Let's read about the Code of Ethics that must be followed when writing a technical piece.
**Code of Ethics in Technical Writing**
The Society for Technical Communication (STC) enumerates six ethical principles of technical communications. These are:
1. Legality
2. Honesty
3. Confidentiality
4. Quality
5. Fairness
6. Professionalism
Visit the Society for Technical Communication (STC) site to read about the ethical principles:
[Ethical PrinciplesLinks to an external site.](https://www.stc.org/about-stc/ethical-principles/).
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from https://www.stc.org/about-stc/ethical-principles/
**References**
Alred, G. J. (2019).
_The handbook of technical writing_(12th ed.). Bedford/Saint Martin's.
Annemarie, H. R. D. (2015).
_Technical writing_.
[https://coccoer.pressbooks.com/Links to an external site.](https://coccoer.pressbooks.com/)
Azusa Pacific Writing Center. (2018, December 18)
_What is Technical Writing?_ Youtube https://www.youtube.com/watch?v=9SB4tfD0hxM
Hamlin, A., Rubio, C., & DeSilva, M. (2015).
_Ethics in Technical Writing – Technical Writing._ [https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/Links to an external site.](https://coccoer.pressbooks.com/chapter/ethics-in-technical-writing/)
Markel, M. (2012).
_Technical Communication_ (10th ed.). St Martin's Press.
Pfeiffer, W. S. (2002).
_Technical writing: A practical approach_ (5th ed.). Pearson.
Race, C. (n.d.).
_Chapter 1: Introduction to Technical Writing_. Open Technical Communication. Retrieved January 11, 2022, from
[https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961Links to an external site.](https://alg.manifoldapp.org/read/open-technical-communication/section/0debb16b-f623-4033-a47b-973d65ab0961)
Society for Technical Communication. (2021, September 21)
_Defining Technical Communication._ [https://www.stc.org/about-stc/defining-technical-communication/Links to an external site.](https://www.stc.org/about-stc/defining-technical-communication/)
STC. (2021).
_Ethical Principles_. Society for Technical Communication; P. Retrieved January 11, 2022, from
[https://www.stc.org/about-stc/ethical-principles/Links to an external site.](https://www.stc.org/about-stc/ethical-principles/)
L. M. Surhone, M. T. Timpledon, & S. F. Marseken, Eds. (2021).
_Defining Technical Communication_. STC. Betascript Publishing.
**Module 1:** _Introduction to Technical Writing_
**Introduction**
Imagine explaining the use of PowerPoint and all its functions to someone who has never worked with the program in a written manual. Where would you start? For describing how to open the program, perhaps, followed by how to create new presentations, add images, or select font? How would you make sure that the student understands everything? For example, with the help of bullet points (step by step), screenshots, or images, for example?
This is a simple example of the questions that a technical writer has to deal with on a day-to-day basis. And not just technical writers, but anyone involved in writing documentation for (complex) technical processes such as reports, processes, or manuals. Technical writing means writing in a way that whoever your target audience is capable of understanding it – regardless of their background or background knowledge. But why is it so important? And what are the best practices when it comes to technical writing? During this course, you will have the opportunity to examine the different types of technical writing genres, compare and contrast with varying writing styles, and try a hand at writing your own in the form of a white paper.
**Defining Technical Writing**
Type in "Technical Writing" in Google, and you may find many definitions of technical writing or technical communications. The Society for Technical Communication (STC) is the world's oldest specialized association devoted to developing technical communication. They define Technical Communication as a broad field that exhibits particular characteristics:
· Communicating
_about technical or specialized topics_, such as computer applications, medical procedures, or environmental regulations.
· Communicating
_using technology_, such as web pages, help files, or social media sites.
· Providing
_instructions about how to do something_, regardless of how technical the task is or even if technology is used to create or distribute that communication (STC, 2021)
In other words, technical writing makes the information accessible to those who need the information. Imagine putting together an IKEA bed without instructions. Where would you begin? Technical Writing also advances the company's goals: for you to come back and purchase other products. If you had a bad experience and found yourself without instructions, would you even go back to the store and get more products from them? Probably not.
You have probably written many essays in school, dabbled in creative storytelling, or even wrote a poem. When you enter the job market, these aren't the types of writing you will encounter or need to produce. Usually, you will be asked to write about how to complete a task, or you will have to read about how a specific software works. These are all examples of Technical Writing. Here are some differences between technical writing and literary writing:
| | |
| — | — |
| Comparison of Technical and Literary Writing |
| **Technical Writing** | **Literary Writing** |
| Use of denotative (explicit) language | Vocabulary more focused on subjectivity is mainly reflected in the use of figures of language. |
| Prevalence serves as a respectful function based on concrete data | Use of the functions: poetic, metalinguistic, and emotional, marked by the subjective spirit of the writer. |
| Objectivity | Use of subjectivity and with a more personal tone. |
| Discourse purpose aims to inform and clarify | Objective focused on entertainment. |
| Fairness and accuracy | Attachment to aesthetic aspects of language. Speech wrapped in a diversity of interpretations. |
| Precise vocabulary | |
Gerson (n.d.) presents the continuum of communication from subjective to objective, from literary creative work to technical writing:
[Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762?wrap=1) [Download Click here for a PDF version of this image.](https://agmu.instructure.com/courses/1811/files/428762/download?download_frd=1)
Gerson, S. M. (n.d.).
_Writing that Works: A Teacher's Guide to Technical Writing_. Kansas Curriculum Center Washburn University.
[https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.htmlLinks to an external site.](https://docplayer.net/10370874-Writing-that-works-a-teacher-s-guide-to-technical-writing-by-dr-steven-m-gerson-johnson-county-community-college.html)