📄 Technical Writer

14-Day English Crash Course for Technical Writers
Intensive Sprint

A focused 2-week programme covering the 14 highest-priority vocabulary and communication areas for technical writers working in English-speaking teams. From plain language and the Diataxis framework to API documentation, SME interview technique, docs-as-code workflows, and changelog writing — each day is practical and directly linked to exercises. Build the English you need to write documentation that people can actually use.

Intensive 14 days · 42 exercises covered · 20–30 min/day · Full 30-day path →
Start Day 1 →

14-day overview

Week 1: Plain Language, Diataxis & API Documentation

1

Plain Language Foundations

2

The Diataxis Documentation Framework

3

Reading Technical Documentation Critically

4

API Documentation Vocabulary

5

Writing API Endpoint Documentation

6

Passive vs Active Voice in Documentation

7

Rewriting Complex Docs into Plain English

Week 2: SME Interviews, Docs-as-Code, Changelogs & Career

8

SME Interviews & Information Extraction

9

Documentation Types: RFCs, Runbooks & ADRs

10

Docs-as-Code: Pull Requests & Review

11

Changelog & Release Note Writing

12

UX Writing & Microcopy

13

Technical Writer Interview English

14

Salary Negotiation & Offer Phrases

Key phrases to learn this fortnight

Diataxis
"This page mixes reference and how-to modes — following Diataxis, I'd split it into two documents."
SME (subject matter expert)
"I need 20 minutes with the SME to confirm the retry behaviour before I can finish this section."
plain language
"I've rewritten this in plain language — active voice, one idea per sentence, no unnecessary jargon."
docs as code
"We migrated to docs as code last year — every page now goes through the same PR review as our application code."
breaking change
"This is a breaking change — the changelog entry 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."
content debt
"We have significant content debt in the webhooks section — three guides describe a flow that's deprecated."
restate for confirmation
"Let me restate that back to confirm I've understood the retry logic correctly before writing it up."
single-sourcing
"We single-source the rate-limit warning so it stays in sync across the quickstart and the API reference."
reader-facing
"Let's phrase the PR description in reader-facing terms — what actually changes for someone reading the docs."

Frequently asked questions

Who is this 14-day Technical Writer English crash course for?

This crash course is for technical writers, documentation engineers, and developers moving into technical writing who need focused, fast improvement in professional English — before a new role, a portfolio review, or when joining an international documentation team. It covers the 14 highest-priority vocabulary and communication areas: from plain language and the Diataxis framework to API documentation, SME interviews, and interview preparation.

What level of English do I need to start?

The course is designed for B1–B2 English learners (intermediate). You should be able to hold basic conversations in English. The course improves your professional and technical writing English, not general English from scratch.

How long does each day take?

Each day is designed for 20–30 minutes: roughly 10 minutes on vocabulary and 15 minutes on the exercise. The intensive format keeps sessions focused — every day is tied directly to vocabulary and scenarios from real technical writing work.

Does this course cover the Diataxis framework?

Yes. Day 2 focuses specifically on the Diataxis documentation framework — the vocabulary for distinguishing tutorials, how-to guides, reference material, and explanation, and the English used to diagnose when a document has drifted between modes.

Is API documentation writing included?

Yes. Days 4 and 5 cover API documentation vocabulary and hands-on practice writing endpoint and parameter descriptions — the precise, structured English used in OpenAPI-based reference documentation.

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

Yes. Day 8 focuses on SME interview technique — funnel questioning, restating answers for confirmation, and tactfully pushing engineers for precision without being adversarial. See /exercises/meetings/ for the practice exercises.

Is docs-as-code and pull request English covered?

Yes. Day 10 covers docs-as-code workflows — writing documentation pull request descriptions, requesting the right kind of review from engineers, and responding to review comments professionally using code review language.

How is this different from the 30-day Technical Writer path?

The 14-day crash course covers the 14 highest-priority areas in a condensed format. The 30-day path goes deeper — adding UX microcopy, style guide governance, content strategy vocabulary, developer advocacy writing, and a full week of career and portfolio communication.

Is there interview preparation in this course?

Yes. Days 13 and 14 cover technical writer interview speaking and salary negotiation phrases. See /exercises/interview/technical-writer-questions/ for the full exercise set.

What should I do after completing this 14-day crash course?

After the crash course, move to the 30-day Technical Writer path for deeper coverage of UX writing, style guides, and content strategy. You can also read the full Technical Writer guide or browse all exercises.

Ready to start?

Begin with Day 1 and spend 20 minutes today.

Start Day 1 → Full 30-day path All learning paths