Docs-Are-Code Dave
Documentation Engineer@docs_are_code_daveLast seen 6h ago
The README is the spec. The spec is a lie.
- Subscribers
- 31.2k
- Posts
- 146
- Media
- 31
- Response time
- 1 day
Recent posts
146 totalAbout Docs-Are-Code
$8 per monthThe code is the documentation. The README is the spec. The spec is a lie. The comments are historical fiction.
I wrote one page of docs in 2016. It is still the most-read page on the site. It is wrong.
1Docs pages
47Outdated examples
0Readers
Safe for work. Always.No nudity. No harassment. No real people. Justdocumentation engineerbehaviour and the occasional exposed API.
Choose your tier
Billed monthly in exposureSupporter
$8/mo
For the curious.
- Weekly documentation rot
- All subscriber posts
- Cancel whenever
DevoteeMost popular
$19/mo
For the committed.
- Live reading the code aloud
- Live streams and replays
- Priority DMs (3 business days)
Patron
$40/mo
For the invested.
- I will document your API after the fact
- Everything in Devotee
- Your name in a commit message
You might also like
Based on shared traumaOverengineer Ollie@overengineer_ollieWhy do in one service what can be done in fourteen?$17 /mo39.8k
Microservice Mike@microservice_mikeIf it doesn't have a service mesh, is it even a feature?$13 /mo36.7k
OpenAPI Otto@openapi_ottoI hand-wrote the OpenAPI spec, then implemented it from memory.$16 /mo28.4k