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.
📃 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…
Best tech companies to work for in America businessinsider.com/payscale-best-…
The @finagle documentation has recently been updated. Check out the new README and go from there: github.com/twitter/finagl…
"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
"Thank your contributors. Be specific. Right away. Publicly." @brittagus 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
"If you’ve got no documentation, it’s a bug." @DrewAPicture at #writethedocs
United States 趨勢
- 1. Flacco 82K posts
- 2. Bengals 78.8K posts
- 3. Bengals 78.8K posts
- 4. Tomlin 21.3K posts
- 5. Ramsey 18.6K posts
- 6. Chase 107K posts
- 7. Chase 107K posts
- 8. #WhoDey 6,701 posts
- 9. #TNFonPrime 5,475 posts
- 10. #WhoDidTheBody 1,365 posts
- 11. Teryl Austin 2,684 posts
- 12. Cuomo 79.4K posts
- 13. #PITvsCIN 6,966 posts
- 14. #criticalrolespoilers 6,302 posts
- 15. Max Scherzer 14K posts
- 16. Andrew Berry 3,139 posts
- 17. Burrow 9,582 posts
- 18. DK Metcalf 3,926 posts
- 19. Zac Taylor 2,511 posts
- 20. Ace Frehley 93.8K posts
Something went wrong.
Something went wrong.