Posts Tagged: documentation

DX Should Be a Priority, Reveals State of API Report 2019

As we make the shift towards treating APIs more like bonafide products, Developer Experience (DX) is only becoming a more prominent topic. Over the last few years, you’ve probably noticed a growing amount of literature, tooling, and discussion on the subject of DX. Read more

5 Examples of Excellent API Documentation (and Why We Think So)

If you’ve been spending much time on the Nordic APIs blog, you’ll know that developer experience is something we’re passionate about. Creating a smooth and enjoyable experience for those implementing your APIs is essential with just how much competition there is nowadays, and API documentation is one of the keys to success. Read more

7 Protocols Good For Documenting With AsyncAPI

Documentation is arguably the most important part of any API strategy, as it’s often the direct route between developer and user, and a direct conduit through which the developer can inform, educate, and contextualize. Accordingly, finding good options for documenting your API is of prime importance. Read more

How Bad Developer Portals Kill APIs

“Reference docs do not constitute developer portals.”

This was the crux of a talk given by Nordic APIs veteran and Pronovix CEO Kristof Van Tomme at our 2017 Platform Summit. His opinion is that developer portals should function as self-service hubs for APIs, allowing developers to access APIs without having to wait around for access keys or any additional information. Read more