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. Bears 87.6K posts
- 2. Jake Moody 13.2K posts
- 3. Snell 23.3K posts
- 4. Falcons 50.4K posts
- 5. Bills 139K posts
- 6. Caleb 47.8K posts
- 7. Josh Allen 26K posts
- 8. #BearDown 2,308 posts
- 9. Jayden 22.2K posts
- 10. Swift 288K posts
- 11. #Dodgers 14.9K posts
- 12. phil 166K posts
- 13. Ben Johnson 4,269 posts
- 14. Turang 4,225 posts
- 15. Bijan 32.1K posts
- 16. Troy Aikman 6,222 posts
- 17. Joji 26.5K posts
- 18. Roki 6,008 posts
- 19. #RaiseHail 8,412 posts
- 20. AFC East 10.4K posts
Something went wrong.
Something went wrong.