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-…
businessinsider.com
The 14 best tech companies to work for in America
Business Insider teamed up with PayScale to find dream-job companies where a premium is placed on employee satisfaction. Here are the best ones in tech.
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. Mets 46.2K posts
- 2. Orioles 16.9K posts
- 3. #TheMaskedSinger N/A
- 4. David Stearns 4,817 posts
- 5. Red Sox 7,351 posts
- 6. Nimmo 2,645 posts
- 7. Bregman 3,328 posts
- 8. Cohen 11.1K posts
- 9. AL East 4,144 posts
- 10. Bellinger 2,953 posts
- 11. John Henry 1,054 posts
- 12. #Supergirl 42.9K posts
- 13. Breslow 1,581 posts
- 14. Polar Bear 2,729 posts
- 15. #Birdland N/A
- 16. Chris Davis N/A
- 17. Yankees 10.6K posts
- 18. FOMC 47.4K posts
- 19. Devers N/A
- 20. Coby Mayo N/A
Something went wrong.
Something went wrong.