Tool the Docs at #fosdem focuses on free and #opensource tools for writing, managing, testing, and rendering… https://t.co/JwIhHjzd0h
This talk was presented at API The Docs Virtual 2020 event series on 10 June. 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!
You have to master the fundamentals of building a developer-facing product before venturing into a more complex, way more expensive and more experimental territory.
"If you do a google search for the best developer portals out there, you are going to find a lot of impossibly high standards. [...]Through a lot of trial and errors, we've been able to come up with a list of the fundamentals [...] that we can double down on, to change the culture in our company for the product to be developer first."
In baseball, trainers teach the fundamentals to major-league players, too. Fundamentals are as important to a tiny startup that is just trying to roll out its first developer-facing product as for Stripe, Twilio, or Apple who have been doing this for a long time.
"Two things the developers really care about the most are Consistency and Reliability. Unless you have those, other stuff doesn't really matter."
A lot of advocates are inside of every company. They are representing different needs and constraints and try to push certain things forward within your product. However, the most important goal is to ship a developer-first product.
Wrong approach: just because you built a product, your audience will come. Do instead:
Documentation - “the instruction manual”
Forums - it’s impossible to answer every questions in the documentation
Support Channel -meet the developers where they are
Tool the Docs at #fosdem focuses on free and #opensource tools for writing, managing, testing, and rendering… https://t.co/JwIhHjzd0h
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