Google Technical Writing Course – Lesson 1: Core Principles and Practical Tips

This note records the first lesson of Google’s Technical Writing course, which aims to teach how to produce high‑quality technical documentation and plan writing activities.

Learning Objectives

After completing the lesson, readers should be able to perform basic technical‑writing tasks, understand the importance of professional terminology, minimize pronoun usage, distinguish active and passive sentences, and apply three methods that favor active voice.

Key Guidelines

Always use professional terms, including abbreviations (e.g.,

K8s

Pod

).

Identify and reduce sentences that rely on pronouns.

Distinguish active from passive statements.

Provide at least three ways to make active sentences preferable.

Develop at least three forms to make sentences clearer and more engaging.

Create at least four strategies for shortening sentences.

Understand the difference between bullet lists and numbered lists.

Construct useful lists.

Write a strong topic sentence for each paragraph.

Keep each paragraph focused on a single theme.

State the main points at the beginning of each document.

Identify the target audience and what they already know.

Recognize the "knowledge disaster" when readers lack required background.

Identify and revise idiomatic expressions.

Define the scope and audience of the document.

Divide long topics into appropriate sections.

Use punctuation correctly, including parentheses, colons, dashes, and semicolons.

Develop beginner‑level skills in Markdown.

Parts of Speech Examples

Nouns : Sam runs a race. Pronouns : He likes competition. Adjectives : Sam wears blue shoes. Adverbs : Sam runs slowly. Prepositions : Sam’s shoes are on his shelf. Conjunctions : Sam’s trophy and ribbon exist only in his imagination. Transitions : Sam competes weekly, but he finishes weakly.

Pronoun Exercise

Original sentence: "C enables programmers to control pointers and memory. Powerful features bring great responsibility." Answer: C, pointers, memory, programmers, features, responsibility.

Pronoun Ambiguity

Example: "Python is an interpreted language, while C++ is a compiled language. It has many followers." The pronoun "it" is ambiguous.

Active vs. Passive Voice

Prefer active constructions such as "The system breaks the loop" over passive forms like "The loop is broken by the system."

Clear and Concise Sentences

Short sentences read faster, are easier to maintain, and reduce misunderstanding. Strategies include expressing one idea per sentence and converting long sentences into lists.

List and Table Usage

Good lists turn chaotic technical content into ordered information, which readers prefer. Bullet lists keep item format consistent, while numbered lists imply order; re‑ordering a bullet list does not change meaning, but re‑ordering a numbered list does.

Markdown

Markdown

is a lightweight markup language widely used by technical professionals to create headings, bold text, lists, and other formatting elements.

References

[1]

Google Technical Writing Course: https://developers.google.com/tech-writing