Skip to main content

Articles

Everything on developer portals from strategy and business to technology and visual design.

Sign up to our newsletter to make sure you don't miss out.

by Laura Vass 7 years 9 months ago

What is an API?

An API is not a thing, it is a weird presence we communicate with, develop and implement. An API is an abstract idea, which is hard to catch for non-developers. I find some concepts challenging to truly understand, let alone explain without context. Take language or loyalty for example. Or an API. What is it? Like Schrödinger's cat, such abstract concepts loose their real characteristics if we try to pin a static definition on them. But if a feline entity is so useful in explaining the quantum state, maybe metaphors would work for APIs too. I studied quantumchemistry, so you see how the cat got here. In this blogpost, I try to show what an API is in action, using metaphors from different professions and the definitions I found on the internet. This one goes out for the lawyer, the med, the interpreter and the writer.
Categories: UX & Research
by 7 years 11 months ago

Frictionless Onboarding: optimize DX on Developer Portals

We wanted to understand the nature of trust issues and to figure out how we can overcome them in order to create a “frictionless” onboarding experience. Here is what we’ve found so far. We hope it’ll be valuable to both users and owners of developer portals.
Categories: UX & Research
by Kathleen De Roo 8 years 3 months ago

Building Landing Pages faster

At Pronovix, we use the paragraphs module almost every day to create new web pages. We continuously evaluate and improve our landing page creation process: we were already able to shorten the feedback process and reduce the number of editing rounds before publishing.
Categories: UX & Research
by 8 years 6 months ago

API Documentation and Developer Portals: common URL patterns

As part of our research into content architecture best practices for Developer Portals, we’ve done a small scale investigation to evaluate what URLs are used by API companies.
Categories: UX & Research
by 8 years 8 months ago

Best practices and UX tips for API documentation

What makes good API docs? To answer that question and help us build the best possible developer portal for a customer, we performed a small inhouse research and reviewed existing blog posts about best practices. The following is a synthesis of what we found.
Categories: UX & Research

Newsletter

Articles on devportals, DX and API docs, event recaps, webinars, and more. Sign up to be up to date with the latest trends and best practices.

 

Subscribe