Rewrite the Docs!
summary
Provides a concrete method: a three-step guide (limit scope, meet people where they are, document everything) used while actually rewriting a coop’s onboarding docs in Google Docs so committee heads can set up and use the coop Gmail accounts; keeps existing systems instead of swapping stacks, documents specific steps and troubleshooting, links help into the UI, asks for an actionable feedback inbox, and recommends image-rich docs and regular updates so the materials are testable and usable by non‑technical staff.
AI-written summary · about
chapters (3)
related talks
40mDocs Tools for OSS Maintainers
29mMove Fast and Document Things: Writing internal docs at fast-moving organizations
20mDo Docs Better: Practical Tips on Delivering...
44mUseful and Beautiful Developer Docs and How to Create Them
40mFrom resistance to adoption: navigating the challenges of docs-like-code
48mUseful and Beautiful Developer Docs and How to Create Them
45mUseful and Beautiful Developer Docs and How to Create Them
35mLearning by Example: Highlights from Google Season of Docs