Honest Take — Before You Begin
This module asks for two transformations and they fail in different ways, so I want to take them separately. The artifact-level one first. The re-engineering exercise will take th…
Two transformations in one module. The artifact-level one: write technical content that teaches rather than just informs — README, release notes, docs, posts. The practice-level one: a publication cadence, a voice readers recognize, and a platform you own. Your blog is your most important production system: durable storage, stable URLs, version control (you're keeping posts in git, right?), organic discovery via search. The post is the row; the cadence is the cron job; the owned domain is the origin server, and hosted platforms are CDNs — useful for distribution, dangerous as the only origin. RFCs and PR descriptions are private deployments of the same skill; the reps transfer in both directions. And Diátaxis is your documentation system's service boundaries: a tutorial, a how-to, an explanation, and a reference are four different services with four different SLOs, and the page that tries to be all four pages at once is the distributed monolith of writing.
This course unlocks once you've finished its prerequisite. Open prerequisite →
This module asks for two transformations and they fail in different ways, so I want to take them separately. The artifact-level one first. The re-engineering exercise will take th…
Writing is the medium most engineers will produce most teaching in: asynchronous, durable, searchable, excerptable. A good post written in 2019 is still teaching in 2026; a good t…
Approach: Essential
Approach: Essential
Approach: Essential
Approach: Essential
Approach: Important
Approach: Important
Approach: Important
1. The re-engineered artifact + reader test — pick one piece of your existing writing (your package's README, a popular post, a core internal doc). Classify it per Diátaxis; rewri…
10 lessons. Read in order; spiral back when you need to. By the end you'll have used the core ideas twice — once on the abstract, once on something you'll meet at work next week.