PortalComment https://www.algolia.com/doc/Beautiful. The “Algolia in 45 seconds“ and “Try Interactive tutorial“ are greathttps://www.twilio.com/docsTwilio and Stripe are regularly mentioned in blog posts and forums as having set high standards for API docs.https://stripe.com/docsDittohttps://docs.aws.amazon.com/I like the top level layout of this portal. There are a lot of APIs documented here, and not all are REST.https://developers.docusign.com/ Docusign has a nice … Continue reading Interesting Documentation Portals

API documentation tasks should be played like any other story by a development team. They should be identified, sized, prioritised, worked on and reviewed. Engineers should lead the initial drafts of writing content pages. It should be done collaboratively with the product managers and Documentarians. The product managers own the sign-off required to move a … Continue reading Docs Are Tasks Too (DTT)

"The primary interaction point where [a developer] can go from awareness, activation and acquisition of an API, be able to bring it up, go to a ‘Hello World’ within maybe 30 minutes, and be able to incorporate [a] product very quickly. So from an organisational view, the developer portal is really a kind of one-stop … Continue reading Quote on Developer Portals and Developer Experience