How to plan a developer portal and learning site around user goals

A developer portal and a learning site do different jobs. Documentation helps someone complete a task or find a precise answer. A learning site takes them from their current level of knowledge to a defined capability. Many organisations put both types of content into the same website without planning how they fit together. The result… Read more »

Podcast 121: What are the skills needed for developing a developer portal?

In this episode of the Cherryleaf Podcast, we look at the skills needed for developing a developer portal. We also talk about our new e-learning course “Creating API documentation and developer portals”, and Google’s recommendations for the content needed on a developer portal. Transcript This is the Cherryleaf podcast. Hello and welcome to the latest… Read more »

Eight typical Use Cases for creating or updating API documentation

Here are some of the common reasons why companies contact us about API documentation: You’ve been providing APIs to your largest customers, together with a lot of onboarding and technical support. You want to have more (smaller-sized) companies use the APIs, but you’re worried about the strain that will place on your Support team. You’re… Read more »

Podcast 118: What’s up Redocly?

Cherryleaf’s Ginny Critcher and Ellis Pratt discuss using the Redocly platform to create a developer portal and API documentation. More information: Redocly Transcript Audio file  redocly-final.mp3    Transcript  Speaker 2 This is the Cherryleaf podcast.  Speaker 3  Hi everybody, welcome to the Cherryleaf podcast. I’m Ginny Critcher and I will be talking to Ellis Pratt… Read more »

Podcast 111: Building a developer portal using Flare – A new way to do it

For a while now, we’ve been looking at ways to import API reference content into MadCap Flare, so that we can use Flare to create a developer portal. Here’s the latest update on what we’ve learnt. Videos: Importing OpenAPI/Swagger API reference content into MadCap Flare 2021 to create a developer portal Importing API reference documentation… Read more »