Dev-first API products, API explorers & Microservices

Dev-first API products, API explorers & Microservices

At the 6th API The Docs Virtual event Egan Anderson, head of developer experience at Galileo, explained ways companies can prioritize developers’ needs. Larry Kluger, lead developer advocate for DocuSign, presented how to create easy to use graphical drag & drop tools for creating and trying complex API requests. Michael Haberman, co-founder & CTO at Aspecto, explored maintaining API production while using microservices to collect data and by that, help development and testing phases. In the Q&A panel of the event, they reflect on their talks and provide further insights on:

  • What are the milestones in API documentation processes?
  • How to make sure all advocates are being heard during the development?
  • How to boost morale & excitement in an internal audience when it comes to API initiatives?
  • Which is a better approach: design-first vs. code-first?
  • Why use Blockly library for API exploring?
  • Is there a need to develop own libraries for open source APIs?
  • How to make your APIs self-documenting?
  • Which are the instances when reducing the number of your services is recommended to maintain your system?

Jaksot(61)

The Ambient AI Future - conversation with Tashfeen Mahmud

The Ambient AI Future - conversation with Tashfeen Mahmud

Tashfeen Mahmud, senior technical writer at Samsung Research in Canada explains why curiosity is your best defense against technical aversion, and how to prepare for a future where technical writers a...

6 Maalis 32min

Streamline release notes: balance AI and human oversight

Streamline release notes: balance AI and human oversight

Senior technical writers Gareth Brinn and Lydia Pedersen talk about using GPTs and n8n to automate release notes: scripting, prompt engineering, and synthesizing data from Jira and GitHub. Next plans ...

25 Marras 202535min

Beyond Access Control: Model-Context Protocol Paradigm

Beyond Access Control: Model-Context Protocol Paradigm

API thought leader Kevin Swiber and Pronovix CEO Kristof Van Tomme join the podcast to explore the Model Context Protocol (MCP) and the emerging governance challenges it presents to API strategy. We d...

21 Loka 202536min

State of the Docs 2025: Insights from GitBook - Discussion with Addison Schultz

State of the Docs 2025: Insights from GitBook - Discussion with Addison Schultz

We discuss findings from GitBook's "State of the Docs" report (2025), for example that 90% view documentation as crucial for purchases, yet 40% of those interviewed don't track its performance. We tal...

14 Heinä 202528min

How AI Impacts Technical Writing Workflows - Discussion with Anila Zaidi and Marco Spinello

How AI Impacts Technical Writing Workflows - Discussion with Anila Zaidi and Marco Spinello

Welcome back to the A(P)I The Docs podcast! We’re opening this new chapter with an absolute treat of an episode in which Anila Zaidi, Staff Technical Writer at Squarespace, and Marco Spinello, Senior ...

16 Kesä 202556min

Documentation by humans for humans - Discussion with Polina Zaichkina and Max Clayton Clowes

Documentation by humans for humans - Discussion with Polina Zaichkina and Max Clayton Clowes

How do you get people on board when you shift to a new tool or a new approach? Even if the value proposition is clear, it might be a challenge to create a practice out of the change.  In this episode ...

18 Heinä 202443min

From Inconsistent to Award-winning Docs - Conversation with Naomi Pentrel & Andrew Feierabend

From Inconsistent to Award-winning Docs - Conversation with Naomi Pentrel & Andrew Feierabend

In this episode, Naomi Pentrel and Andrew Feierabend share their journey of revamping Viam’s robotics APIs documentation. They discuss the benefits of sitting down with actual users in well-structured...

8 Heinä 202450min

The Secret Sauce of Developer Programs: A Conversation with Byrne Reese

The Secret Sauce of Developer Programs: A Conversation with Byrne Reese

Byrne Reese had the opportunity to build a number of developer programs over the years. In this episode, he explains his unique Developer Pyramid framework which he uses as a guide to build a successf...

27 Kesä 202456min