I spent two years trying to do what Backstage does for free
Absent a time machine, telling others how to avoid my mistakes is the best I can do.
Experts from Stripe and Waymo explain how to craft great documentation (Ep. 455)
We chat with Jared Bhatti and Zachary Sarah Corleissen, two technical writers with deep experience at major tech companies and open source projects, about their approach to documentation and the new book they helped co-author, Doc For Devs.
Eira May
Content Writer
Building a community of open-source documentation contributors
When your open-source project starts getting contributors, it can feel great! But as a project grows, contributors can neglect to document everything.
Empathy for the Dev: Avoiding common pitfalls when communicating with developers
All too often, developers go deep on the wrong things, when writing documentation. A little bit of empathy can get your docs back on track.
“This should never happen. If it does, call the developers.”
If there is one thing developers like less than writing documentation, it's responding to unnecessary escalations.
Thomas A. Limoncelli
Site Reliability Engineering Manager
How Stackers ditched the wiki and migrated to Articles
In an effort to rethink how documentation works, we recently introduced Articles, longer-form prose that can sit side by side with shorter Q&A.
Tales from documentation: Write for your clueless users
When you're documenting anything technical, it's easy to forget what it's like being ignorant of how the software works, especially if you built the thing.