Erthiox course audio
← Back to text lessons
Technical Writing
Listen to the audio to unlock the exam – or finish the lessons instead. Either path opens the same exam, and passing it earns the certificate. Prefer reading? Use the button above to go back to the 50 text lessons.
WRITING THAT HELPS
Writing that helps people do things
Technical writing is not creative writing with jargon added.
If the reader cannot act, the document failed, however elegant its sentences.
✓✓
KNOW YOUR READER
Know your reader, say exactly what you mean
Say exactly what you mean follows from that.
✓
DOCUMENT TYPES DIATAXIS
Document types: Diataxis
The Diataxis framework gives you four document types, and choosing the right one prevents most structural mistakes.
✓
CHUNKING STEPS AND
Chunking, steps, and warnings
Chunking and scannability are about respect for the reader's attention.
Warnings, notes, and troubleshooting need care too.
✓✓
API DOCS DIAGRAMS
API docs, diagrams, and screenshots
Anatomy of good API docs starts with the reader's task, not the endpoint list.
✓
REVIEW TESTING AND
Review, testing, and docs as code
Technical review versus editorial review is a distinction that saves documents.
✓
ACCESSIBLE DOCUMENTATION
Accessible documentation
Accessible documentation is not an optional extra.
Add text alternatives to diagrams and screenshots that carry meaning.
✓✓
YOUR SEVEN DAY
Your seven day plan
Here is your seven day plan.
Day four: define three terms on first use in a document you know well.
Seven days, real documents, tested by a real reader.
✓✓✓
CLOSE AND THE
Close and the exam
See you in lesson one.
✓
0:00 / 9:29
Watched 0:00
Listen to the audio to unlock the exam.
Audio complete – you can now take the exam. Continue to exam.
That's the audio.
Listen again, read the lessons, or take the exam when you are ready.
Captions are on by default. Keyboard: Space play/pause, arrows seek 5s, M mute, F fullscreen player.