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. #IDontWantToOverreactBUT N/A
- 2. #GoldenGlobes 66.7K posts
- 3. Paramount 26.1K posts
- 4. #MondayMotivation 10.3K posts
- 5. Good Monday 53.2K posts
- 6. NextNRG Inc 1,045 posts
- 7. #NXXT_NEWS N/A
- 8. Victory Monday 1,953 posts
- 9. Tekken 30K posts
- 10. Harada 12.8K posts
- 11. #MYNZ_CRCRevolution N/A
- 12. JUNGKOOK X ROLLING STONE 63.7K posts
- 13. Mainz Biomed N.V. N/A
- 14. ORM HAUS NOWHERE GOP 863K posts
- 15. John Lennon 13.2K posts
- 16. Eva Victor 1,639 posts
- 17. Immaculate Conception 14.5K posts
- 18. Will Hall 4,995 posts
- 19. BDAY 28.5K posts
- 20. MAGICAL WITH WILLIAMEST 421K posts
Something went wrong.
Something went wrong.