Minimal Viable API Documentation and Developer Experience

Minimal Viable API Documentation and Developer Experience

On 22th April Mike Jang from GitLab explored what an Minimum Viable Documentation is for RESTful APIs. Jenny Wanger explained that the way you name, design, and structure your APIs has a huge impact on usability. In the Question-and-Answer session after their presentations, Jenny and Mike reflect on their talks and provide further insights. Enjoy!

Episoder(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 Mar 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 Nov 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 Okt 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 Jul 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 Jun 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 Jul 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 Jul 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 Jun 202456min

Populært innen Teknologi

lydartikler-fra-aftenposten
romkapsel
teknisk-sett
smart-forklart
elektropodden
nasjonal-sikkerhetsmyndighet-nsm
energi-og-klima
rss-ki-praten
rss-impressions-2
fornybaren
shifter
tomprat-med-gunnar-tjomlid
rss-heis
rss-ai-forklart
rss-alt-vi-kan
rss-alt-som-gar-pa-strom
pedagogisk-intelligens
rss-praktisk-proptech
rss-fjorsilkebris-podcast
rss-anleggspraten