docs


Open Source Documentation: One Year Later

Community, Technical
SendGrid docs

A year ago, we open sourced our documentation, with the hypothesis that it would improve the docs by adding feedback loops and removing barriers that discourage contribution. We also wanted to share what we had learned during the process. I’m glad to say that so far the results have been good, and the decision to open source our documentation continues … Read more ›


Why We Open Sourced Our Documentation

Product, Technical
SendGrid docs

I talk a lot about docs, because it’s important to me and important for the success of a product. You can read some of my thoughts on what makes good documentation and using Jekyll to create documentation. One of the goals I set last year when I was asked to take over the documentation was to eventually open source it. … Read more ›


Cheat Codes for Good Documentation

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 ›


New SendGrid Documentation Launched

Company, Product
docs

Today SendGrid is excited to announce our new and improved documentation! Some of the highlights of the new system are: Quicker load times Improved navigation and organization More relevant search results Increased legibility Cleaner presentation of code samples Ability to toggle between JSON and XML examples The new system will allow us to collaborate on updates and changes much more … Read more ›


SendGrid’s API Workshop – Interactive API Documentation

Best Practices, Product, Technical

We have updated this system and moved it, please check out our Code Workshop here.

Sometimes it’s easier to understand how something works by seeing it in action rather than by reading about it. To make it easier to explore what our API is capable of and let customers try out API calls without having to write code, we’ve created our API Workshop.

Ready to take it for a spin? Start by putting in your SendGrid credentials:

API Workshop Credentials

… Read more ›