Documenting API developer portals

  • Fachvortrag
  • Softwaredokumentation
  • 10. Juni
  • 09:30 - 10:30 AM (MEZ)
  • beendet
  • Folien
  •  Swapnil Ogale

    Swapnil Ogale

    • Redocly

Inhalt

APIs do not have an interface, right? Most of it is code (actually all of it) that allows business and users to do some incredible stuff across their products. So, what is it that is keeping them from using these APIs to their fullest potential? You guessed it. Good documentation.

 

In this talk, I will draw on my recent experience with documenting APIs and developer portals to provide a full picture of how they work and where they’re used.

Das lernen Sie

Key takeways:

a. Pain points around API documentation

b. How Developer Portals have evolved and how they effectively are the UI of APIs

c. Skills technical writers bring to API docs

d. Best practices around API dev portals

Vorkenntnisse

Basic understanding of API documentation

Referent:in

 Swapnil Ogale

Swapnil Ogale

  • Redocly
Biografie

Technical Writer, Community Wrangler, and Professional Speaker.