An award-winning developer portal requires great accessibility, easy navigation, a mobile-friendly design, and a cl… https://t.co/1N2TSLgDdx
This talk was presented at API The Docs Virtual 2020 event series on 22 April. We are glad to present the video recording, slide deck and talk summary below. Enjoy!
Visit our talk recaps ToC page for an overview of all presentations!
Build something that people need.
Bring everything and everybody in (end users, design, data, product, ...) to understand the problem to solve. Think about business strategy (also for internal APIs!).
Techniques
Key equations
Navigate broad pieces easily, understand the major steps.
Have ideas about who your customers are, who you are trying to serve. Create different journeys. Find the balance between the developers’ mental models and the industry of the business they are working in.
Techniques
Correct underneath structures.
Think through the structure of the API request & response body. Get a basic outline of each endpoint.
Techniques
Tweak the final bits, find perfection.
Decide on the fine details. Use usability testing techniques.
Usability testing via Postman or Swagger. Needed: clear steps and moderation guide.
Just as with new APIs: iterate! Don’t let an already-built API stop you from building the right API.
An award-winning developer portal requires great accessibility, easy navigation, a mobile-friendly design, and a cl… https://t.co/1N2TSLgDdx
💡 Which team should we interview in the upcoming season of the API Resilience #podcast? 💡 Any people in the #API sc… https://t.co/QRuWUfanbQ
RT @DevportalAwards: 💡 What would you say if we introduced industry based categories in 2021? Do you like the idea? Also, any iteratio… https://t.co/MpRDC9k6RU
How to win with frictionless onboarding and success in developer adoption? 💡 Here's our take with features availabl… https://t.co/PYOXiuLZ71
Was great fun to chat about @ford APIs and self-driving cars on the @pronovix podcast with @mswinberry @kvantomme -… https://t.co/whp6kJ1azY