Developer Portals: when Docs become DX

Developer Portals Technology

Developer Portals: when Docs become DX

March 29, 2018

Developer portals play not only a technical role, they also play a somewhat obscure commercial role. We don't like to say that this is a commercial site, but actually it is also about promotion. You have to explain what you do – preferably not in a hard-core manipulative way. For that, you need more than reference docs. How to get started? What does that API do? A lot more than just the very technical aspects need to be explained.

A less well circulated purpose of developer portals is their being a trust signal. They engender trust by showing how much investment went into building that portal. They have to show that the API services documented on that portal will keep on existing and will get reliable support long term.

Read more
What is the MVP for a Developer Portal?

Developer Portals

What is the MVP for a Developer Portal?

December 21, 2017

What information is absolutely essential on a developer portal? What kind of API documentation do you need? Is there a best practice that can be followed when launching a developer portal? We formulated 11 questions and built 3 mock sitemaps that demonstrate how portals can address the different stages of the developer journey.

Read more
The Function of API Use Cases & Case Studies on Developer Portals

Developer Portals

The Function of API Use Cases & Case Studies on Developer Portals

October 25, 2017

Should use cases and case studies be part of your API documentation? They play two crucial roles on a developer portal: They act as social proof for your API product (sales function) and they can be an introduction to more specific, implementation scenario documentation types.
We explored these fringe documentation types, both on business sites and developer portals, of 18 API companies with different profiles.

Read more
What is the Difference Between API Documentation and a Developer Portal?

Developer Portals

What is the Difference Between API Documentation and a Developer Portal?

August 31, 2017

A developer portal is more than just the documentation for an API. As a sort of self-service support hub, it is a key DevRel tool that helps an organization to provide the best possible developer experience for its APIs. A developer portal has a role in support, marketing, sales, and engineering. A conversation on the #documenting-apis WTD slack channel sparked the idea for this blog post.

Read more
DevRelCon Beijing 2017

Developer Portals

DevRelCon Beijing 2017

August 17, 2017

Seven years ago I had the chance to visit China, and I had a great time exploring the cultural heritage, large cities and gastronomy. So when my talk got accepted for the first DevRelCon in Asia, I was excited to see China again — this time from a professional point of view.

Read more
Treat docs like code

Technology

Treat docs like code

July 27, 2017

On the Write The Docs London meetup in January speakers from leading Git code repositories talked about how their teams dogfood their own tools to do their documentation. Version the Docs covered Bitbucket and GitLab, but we missed a GitHub presentation. To fill this gap, we interviewed Anne Gentle about GitHub, treating docs like code, and community contributions to documentation.

Read more
API Documentation at WTD NA 2017

Developer Portals News & Events

API Documentation at WTD NA 2017

June 1, 2017

The annual North-American Write The Docs conference this year featured 2 API documentation redo presentations:

  1. Lyzi Diamond described Mapbox (formerly a part of Development Seed) documentation automagic in detail,
  2. Sarah Hersh talked about the journey that NPR One undertook towards a new task-based approach for their API's developer documentation.

In this post we aim to give you an account of these presentations.

Read more