best practices


Cheat Codes for Good Documentation

Brandon West Best Practices, Technical
Still my favorite Programming Manual
Still my favorite Programming Manual

The Best Programming Manual

Everybody, especially developers, loves working on documentation. They understand the importance of docs and its impact on customer adoption and customer experience, and they always consider docs when planning and releasing code. Wait, why are you laughing?

Many companies have some kind of trouble with documentation. Lots of common problems make docs difficult to wrangle; information gets out of date or lacks completeness, the content is poorly organized or inconsistent, readers can’t find what they’re looking for, and code samples might be broken. If you walk through most engineering departments and ask for volunteers to help update docs, you’ll be met with silence if not outright derision.

The truth is that there are no cheat codes for creating a culture that values documentation or for creating quality content, but I’d like to share some practical things I’ve learned while trying to do just that at SendGrid, and hopefully give you a few extra lives (or at least some extra quarters) for your game.

… Read more ›


Customer Success: SendGrid Becomes the Mayor of foursquare

Best Practices
foursquare

 If you’re familiar with location based services, then you are most certainly aware of foursquare – the mobile platform that makes cities easier to use and more interesting to explore. At SendGrid we are caught up in the craze and quite competitive internally for our foursquare points and mayorships.  While most communication between foursquare users happens within the application,  email alerts, friend requests, check ins, and “mayorship” status result in over 60 million transactional emails sent per month. … Read more ›