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. Chiefs 62.7K posts
- 2. Texans 28.3K posts
- 3. Mahomes 19.3K posts
- 4. #ITWelcomeToDerry 27.7K posts
- 5. #BaddiesUSA 15.7K posts
- 6. CJ Stroud 2,570 posts
- 7. Collinsworth 3,458 posts
- 8. Chris Jones 2,148 posts
- 9. Jeff Kent 7,633 posts
- 10. Caleb 58.5K posts
- 11. Pitre 3,525 posts
- 12. Bears 87.9K posts
- 13. Packers 76.2K posts
- 14. Rashee Rice 1,115 posts
- 15. #SNFonNBC N/A
- 16. #HOUvsKC 1,301 posts
- 17. Butker 2,929 posts
- 18. Pacheco 3,262 posts
- 19. Notre Dame 181K posts
- 20. Spags N/A
Something went wrong.
Something went wrong.