📄 Technical Writer

30-Day English for Technical Writers
Complete Learning Path

A structured day-by-day programme covering every area of English that technical writers use in professional teams. You will build vocabulary for plain language and the Diataxis framework; learn the precise register of API documentation and changelog writing; practise SME interview technique and docs-as-code collaboration; and develop UX microcopy and content strategy skills. Each day is 20–30 minutes with direct links to exercises, vocabulary sets, and phrasebooks.

Beginner – Intermediate 30 days · 90 exercises covered · 20–30 min/day · Full role guide →
Start Day 1 →

30-day overview

Week 1: Plain Language & Diataxis Foundations

1

Plain Language Core Principles

2

The Diataxis Documentation Framework

3

Reading Technical Documentation Critically

4

Passive vs Active Voice

5

IT Collocations for Documentation

6

Rewriting Complex Docs into Plain English

Week 2: API Documentation & Technical Depth

7

Word Formation for Technical Vocabulary

8

Git & Version Control for Documentation

9

Documentation Types: RFCs & ADRs

10

Knowledge Base & Runbook Writing

11

API Documentation Vocabulary

12

Writing API Endpoint Documentation

Week 3: SME Collaboration & Docs-as-Code

13

API Spec & OpenAPI Vocabulary

14

API Design & Versioning Language

15

Code Comment & Docstring Language

16

SME Interviews & Information Extraction

17

Docs-as-Code: Pull Requests & Reviews

18

GitHub Platform & PR Template Language

Week 4: Content Strategy & UX Writing

19

Async Communication & Slack Norms

20

Stakeholder Management for Writers

21

Changelog & Release Note Writing

22

CI/CD Pipeline Language for Docs Builds

23

UX Writing & Microcopy

24

Developer Advocacy Content Writing

Week 5: Career & Interview

25

Technical Content Creation: Tutorials & Blogs

26

Onboarding & Knowledge Transfer Writing

27

Technical Writer Interview English

28

Technical Interview Speaking Practice

29

Salary Negotiation Language

30

Final Review: All Key Phrases

Key phrases to learn this month

Diataxis
"This page mixes reference and how-to modes — following Diataxis, I'd split it into two documents."
content debt
"We have significant content debt in the webhooks section — three guides describe a deprecated flow."
docs as code
"We migrated to docs as code — every page goes through the same PR review as our application code."
SME (subject matter expert)
"I need 20 minutes with the SME to confirm the retry behaviour before I finish this section."
breaking change
"This is a breaking change — the changelog needs a migration note, not just a one-line description."
style guide
"Per our style guide, second person is only used in how-to guides, never in reference pages."
progressive disclosure
"We use progressive disclosure — the basic config is inline, advanced options are collapsible."
single-sourcing
"We single-source the rate-limit warning so it stays in sync across the quickstart and reference."
microcopy
"The microcopy on this error state needs to explain the fix, not just state that something failed."
reader-facing
"Let's phrase the PR description in reader-facing terms — what actually changes for the reader."

Frequently asked questions

What does this Technical Writer English path cover?

The path covers plain language principles, the Diataxis documentation framework, API documentation writing, SME interview technique, docs-as-code pull request workflows, changelog and release note writing, UX microcopy, and technical interview preparation — all the English a technical writer needs to work effectively in an international team.

Is this path suitable for developers moving into technical writing?

Yes. Days 1–10 build the foundational vocabulary and Diataxis framework that any writer needs, regardless of background. Developers already comfortable with Git and PRs will find Week 3 (docs-as-code) especially fast to pick up, while Week 4 (UX writing, content strategy) introduces skills less familiar to engineers.

What API documentation content is included?

Week 2 (Days 11–15) focuses entirely on API documentation: endpoint and parameter description vocabulary, writing endpoint documentation, OpenAPI spec vocabulary, API versioning language, and code comment/docstring conventions.

Does the path cover interviewing subject matter experts (SMEs)?

Yes. Day 16 covers SME interview technique in depth: funnel questioning, restating answers for confirmation, and the diplomatic language used to push engineers for precision without appearing adversarial.

Is docs-as-code covered — Git, pull requests, and reviews?

Yes. Days 17 and 18 cover writing documentation pull request descriptions, requesting the right kind of review from engineers, responding to review comments, and GitHub platform vocabulary including PR templates and CODEOWNERS.

Is UX writing and microcopy included?

Yes. Day 23 focuses on UX writing and microcopy — error messages, empty states, button labels, and confirmation dialog language, which is increasingly expected of technical writers contributing to product UX.

What changelog and release note vocabulary is covered?

Day 21 covers changelog and release note writing: the "Keep a Changelog" conventions, flagging breaking changes, and calibrating register for developer-facing versus customer-facing release notes.

Is the path suitable for beginner technical writers?

Yes. The path is marked Beginner–Intermediate and starts with foundational plain-language and Diataxis vocabulary before progressing to more advanced topics. If you are completely new to technical writing, spend extra time on Days 1–10 before moving forward.

What should I do after completing this 30-day path?

After the 30-day path, explore the Technical Writer guide for comprehensive reference material, or browse /exercises/technical-writing/ for additional exercises. If your role involves API-heavy documentation, the Backend Developer path is a useful complement.

Ready to start?

Begin with Day 1 and spend 20 minutes today.

Start Day 1 → All learning paths Browse all exercises