TechDocs

Great reminder that error messages are documentation and can be tremendously informative. A well-written error message can save your users (or yourself!) a huge amount of grief. twitter.com/b0rk/status/11…

📃 Documentation is a developer's first impression of your project—and *great* docs show a commitment to empathy+respect: welcoming people wherever they are, and patiently helping them move to the next level. Docs are such a powerful way to care for users, to build a community.

Last week @TechDocs hosted writers from @Uber, @facebook, @autodesk, and @LinkedIn at @TwitterSF for a 💯conversation. Looking forward to more of these! (Shoutout to Shannon B. for the pic 📷)

Brilliant talk from @rionam: "Documentation is core engineering work." usenix.org/conference/sre…

Looking for tech writers to join our @TechDocs team at Twitter. DM me if interested. careers.twitter.com/en/work-for-tw…

Best tech companies to work for in America businessinsider.com/payscale-best-…

@travisbrown welcome to the flock!

The @finagle documentation has recently been updated. Check out the new README and go from there: github.com/twitter/finagl…

Notes from #writethedocs conference: medium.com/p/7426ae1370d5

"Markdown + Git = Flexible and Scalable Documentation" @patrickarlt at @writethedocs

"What users what the most: written instructions (HOWTOs) and sample code." @Moz's Zach Corleissen at #writethedocs

@lane @secretasianman There should be video of all the talks.

"Measure TTHW: Time To Hello World." @jaredbhatti at #writethedocs

@marius @scotmarvin Right on.

"Thank your contributors. Be specific. Right away. Publicly." @brittagus at #writethedocs

“Done is beautiful” @scotmarvin at #writethedocs

"Write like Hemingway - use short sentences. Try hemingwayapp.com" @scotmarvin at #writethedocs

"Instrumentation helps documentation, and documentation helps instrumentation. Complex systems need both." @bltroutwine at #writethedocs

Poka-yoke: Japanese for "mistake-proofing" #reliability: en.wikipedia.org/wiki/Poka-yoke

"Fix product failures instead of documenting around it." @xiongchiamiov at #writethedocs