TECHNICAL WRITING ONE
INTRODUCTION
Technical Writing One teaches you how to write clearer technical
documentation.
Target audience
You need at least a little writing proficiency in English, but you don't
need to be a strong writer to take this course
If you've never taken any technical writing training, this course is
perfect for you. If you've taken technical writing training, this class
provides an efficient refresher
Learning objectives
This course teaches you the fundamentals of technical writing. After
completing this class, you will know how to do the following:
Use terminology—including abbreviations and acronyms—
consistently.
Recognize ambiguous pronouns.
Distinguish active voice from passive voice.
Convert passive voice sentences to active voice.
Identify three ways in which active voice is superior to passive
voice.
Develop at least three strategies to make sentences clearer and
more engaging.
Develop at least four strategies to shorten sentences.
Understand the difference between bulleted lists and numbered
lists.
Create helpful lists.
Create effective lead sentences for paragraphs.
Focus each paragraph on a single topic.
State key points at the start of each document.
Identify your target audience.
Determine what your target audience already knows and what your
target audience needs to learn.
Understand the curse of knowledge.
Identify and revise idioms.
State your document's scope (goals) and audience.
Break long topics into appropriate sections.
Use commas, parentheses, colons, em dashes, and semicolons
properly.
Develop beginner competency in Markdown.
[Link]
NO Part of Definition Example
Speech
1 Noun a person, place, concept, or Sam runs races
thing
2 Pronoun a noun that replaces another Sam runs
noun (or larger structure) races. He likes
to compete
3 Adjective a word or phrase that Sam wears
modifies a noun blue shoes.
4 Verb an action word or phrase Sam runs races
5 Adverb a word or phrase that Sam runs
modifies a verb, an adjective, slowly.
or another adverb
6 Preposition a word or phrase specifying Sam's sneakers
the positional relationship of are seldom on
two nouns his shelf
7 Conjunction a word that connects two Sam's trophies
nouns or phrases and ribbons
live only in his
imagination.
8 Transition a word or phrase that Sam runs races
connects two sentences weekly.
However, he
finishes races
weakly.
Nouns
Nouns represent people, places, or things. Judy, Antarctica, and
hammers are all nouns, but so are intangible concepts like
robustness and perfection. In the following example passage, we've
formatted the nouns in bold: