Hubs We Love ❤️ Little Details With a Big DX Impact

We’re big believers in “big little details” as a way to make the compass spin, so today we’re highlighting a few customers that bring that extra special attention to their hubs. API documentation is so much more than putting together your API reference, writing a few guides, and calling it a day. Your docs are your developer hub: how you onboard users to your API, help them troubleshoot issues quickly, and understand their API usage so you can make smart investments in new features and functionality. With your docs serving all of those purposes, it only makes sense to go the extra mile on the details 🔎

Beyond the core components of your hub like your API reference or changelog, take the opportunity to bring a little magic to your developer experience. Here are a few of our favorite examples to inspire you:

Will the sun come out, Tomorrow.io? ☀️

Tomorrow.io provides enterprise-grade APIs that enable companies to integrate weather data into their products, alert customers about potential weather events, monitor weather-related risks, and more.

Their hub’s landing page gives new users everything they need to get started. It guides existing users towards the information they need, from the “Get Your API Key” call to action to the“Featured Recipes” section. Having their most popular use cases in one place makes it easy for new users to find what they’re looking for.

GIF of Tomorrow.io's landing page to their API documentation

And when users do find their use case, they’ll be able to get started right away, thanks to the inclusion of a“Run in Postman” button in Tomorrow’s recipes. Tomorrow has also embedded the recipes in related endpoints, so that users exploring the API reference can see use cases in context.

Screenshot of API recipes embedded into API reference page

Welcoming new partners with Gusto 👋

Gusto’s developer hub covers two APIs: one for integrating Gusto with other apps or workflows, and the Embedded Payroll API supporting their new product, Gusto Embedded. One of their top goals for their hub was to help new customers and partners understand the wide-ranging possibilities and inspire them to build with Gusto.

With that in mind, they customized their build with a drop-down API switcher in their hub navigation to let users easily switch between the docs for Gusto Embedded and for Gusto App Integrations. The color scheme is very different for each API, making it easy for the user to see at a glance if they’re in the right spot.

GIF showing Gusto API docs switching between app integrations and embedded payroll documentation

When evaluating a formal partnership, a key consideration is security and usage policies (it may not be the most exciting topic, but it’s important!). Gusto’s made it easy for potential partners to find and review these policies, with clearly labeled links to both in their navigation.

Keeping healthcare Capable 🏥

Capable offers a modern way to build digital health experiences, making it faster and easier for developers and product teams to create patient-centered healthcare apps. The intro page for their docs maintains the same focus on quick, easy understanding, with a high-level system diagram front and center.

Screenshot of Capable's intro page to their API docs

They’ve also gotten creative with emojis to help users understand token access. For each endpoint, they’ve added custom content with a handy key for their three token types — M2M, Patient, and Practitioner — and whether they work with that specific endpoint.

Screenshot with custom content added to API endpoint reference page

Be Tremendous(ly) efficient ✅

Tremendous makes it easy to send mass payouts to recipients around the globe, with hundreds of options for how a payout can be redeemed. Given that their product is all about streamlining a tedious, time-consuming process, it makes sense that their docs are designed with efficiency in mind. Their introduction links directly to the core concepts, sandbox environment, and quickstart guide, as well as client libraries.

Screenshot of Tremendous's API docs introduction page

There’s nothing more annoying than starting a project…only to realize that you have to go back and do something else first 😭 Tremendous helps developers avoid that by listing prerequisites at the top of the page, complete with links to the necessary guides to actually finish those tasks. Now, it’s that much easier for their users to minimize backtracking.

Screenshot showing a page of API documentation that has prerequisites listed at the top

Details can make all the difference ✨

We hope these examples have given you some ideas on how you can add a little je ne sais quoi to your docs! And if you have any questions on how you can implement similar details on your developer hub, feel free to reach out via email at [email protected], or by sending a message from your project dashboard 💌