Editorial Services as a Central Utility for API Teams

Developer Portals

Editorial Services as a Central Utility for API Teams

October 3, 2018

Most organizations never consciously address the experience of the developers that create APIs, the upstream. This is only logical, upstream Developer eXperience doesn’t always need attention: a team that is dedicated to APIs will overcome friction on its own terms. In large enterprise organizations, however, where API development might be a secondary priority of a team, upstream DX can make the difference between a failed and a successful digital transformation initiative.

Read more
API Docs Apprenticeship Program

Developer Portals News & Events

API Docs Apprenticeship Program

August 30, 2018

The goal of our API Documentation Apprenticeship program is dual. It provides technical writer skills for our clients and it is an opportunity for novice API documentarians to gain credentials by working on enterprise projects under the guidance and supervision of experienced mentors.

Read more
Analyzing the API Docs and DX Patterns in the Best Banking Developer Portals

Developer Portals

Analyzing the API Docs and DX Patterns in the Best Banking Developer Portals

May 24, 2018

PSD2 and a swarm of Fintech guerilla competitors are shaking up the banking sector. A large number of financial institutions decided to embrace the change, and to execute an Open banking strategy. As a direct result, a lot of new APIs and developer portals for banking services are now available on the public web. From the numerous developer portals we found, we’ve selected some of the best portals that demonstrate the innovations and best practices to enhance developer experience in the banking context.

Read more
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