Mastering API Documentation Instructor-Led Virtual Training
Save $250 off the cost of training when you use discount code — TCW — at checkouot
APIs power the digital world, but without clear, well-structured documentation, even the best APIs can be frustrating to use. Whether you’re a technical writer, developer, or anyone working with APIs, mastering API documentation is essential for creating a seamless developer experience.
Join API documentation expert Mark Wentowski (Docs Geek) for the Mastering API Documentation Workshop Series – Summer School Edition, offered in two sessions this summer:
Summer 1: Begins May 5
Summer 2: Begins July 7
This seven-course series covers everything from API fundamentals and structured data to OpenAPI, authentication, and refining API references. Each session is designed with hands-on exercises using industry-standard tools like Swagger UI, Postman, Curl, and Mermaid, ensuring you gain practical, real-world skills.
Don’t miss this opportunity to sharpen your API documentation expertise with guidance from an industry veteran. Choose the session that fits your schedule and take your API documentation skills to the next level!
About the instructor
Mark Wentowski (Docs Geek) is an API Documentation Specialist with over 13 years of experience producing global, web-based, developer-to-developer documentation for web services, libraries, and other software products.
Summer Session 1 — Class begins May 7, 2025
🗓️ May 5 — Course 1: Understanding APIs
This class introduces the fundamentals of APIs, covering their purpose, how they function, and how to interact with them using tools like Curl, web browsers, and JavaScript applications. It also explores API documentation, its key components, and the tools used to create and maintain it, with hands-on exercises in Swagger UI.
🗓️ May 12 — Course 2: Structured Data & JSON
This class explores structured data with a focus on JSON, covering its format, objects, arrays, and nesting. It includes hands-on exercises with Swagger UI and Postman to construct and send JSON requests, interact with APIs, and handle authentication.
🗓️ May 19 — Course 3: OpenAPI Deep Dive (Part 1)
This class provides a deep dive into OpenAPI and YAML, covering key components like the Info Object, servers, paths, operations, and responses. Through hands-on exercises in Swagger Editor and Curl, participants will practice structuring API definitions, troubleshooting errors, and making API requests.
🗓️ June 2 — Course 4: OpenAPI Deep Dive (Part 2)
This session focuses on query parameters, authentication, and CRUD operations in OpenAPI and Curl. Participants will practice constructing API requests, handling security schemes, and documenting API interactions using Curl and Swagger UI.
🗓️ June 9 — Course 5: API Flows & Diagramming (Part 1)
This session covers user journeys, API flows, and diagramming with Mermaid. Participants will map user interactions, translate them into API flows, and practice authentication flows in a React Admin Panel.
🗓️ June 16 — Course 6: API Flows & Diagramming (Part 2)
This session focuses on the sequence diagramming of API flows, including user login, admin login, and patron actions, using tools like Curl and Mermaid. Participants will diagram and analyze authentication and admin/patron API flows, then apply their learning with hands-on exercises using Postman.
🗓️ June 23 — Course 7: Refining API References
This session focuses on refining API references, covering topics like the difference between formal and informal elements, documenting endpoints, fields, and status codes, and writing error messages. Participants will practice these concepts through hands-on exercises in the Swagger Editor, improving the ability to create clear and detailed API documentation.
Summer Session 2 — Class begins July 7, 2025
🗓️ July 7 — Course 1: Understanding APIs
This class introduces the fundamentals of APIs, covering their purpose, how they function, and how to interact with them using tools like Curl, web browsers, and JavaScript applications. It also explores API documentation, its key components, and the tools used to create and maintain it, with hands-on exercises in Swagger UI.
🗓️ July 17 — Course 2: Structured Data & JSON
This class explores structured data with a focus on JSON, covering its format, objects, arrays, and nesting. It includes hands-on exercises with Swagger UI and Postman to construct and send JSON requests, interact with APIs, and handle authentication.
🗓️ July 21 — Course 3: OpenAPI Deep Dive (Part 1)
This class provides a deep dive into OpenAPI and YAML, covering key components like the Info Object, servers, paths, operations, and responses. Through hands-on exercises in Swagger Editor and Curl, participants will practice structuring API definitions, troubleshooting errors, and making API requests.
🗓️ July 28 — Course 4: OpenAPI Deep Dive (Part 2)
This session focuses on query parameters, authentication, and CRUD operations in OpenAPI and Curl. Participants will practice constructing API requests, handling security schemes, and documenting API interactions using Curl and Swagger UI.
🗓️ August 4 — Course 5: API Flows & Diagramming (Part 1)
This session covers user journeys, API flows, and diagramming with Mermaid. Participants will map user interactions, translate them into API flows, and practice authentication flows in a React Admin Panel.
🗓️ August 11 — Course 6: API Flows & Diagramming (Part 2)
This session focuses on the sequence diagramming of API flows, including user login, admin login, and patron actions, using tools like Curl and Mermaid. Participants will diagram and analyze authentication and admin/patron API flows, then apply their learning with hands-on exercises using Postman.
🗓️ August 18 — Course 7: Refining API References
This session focuses on refining API references, covering topics like the difference between formal and informal elements, documenting endpoints, fields, and status codes, and writing error messages. Participants will practice these concepts through hands-on exercises in the Swagger Editor, improving the ability to create clear and detailed API documentation.
This training series looks super comprehensive! I've been wanting to get better at documenting the APIs I work with, and the hands-on exercises with tools like Postman are a huge plus. I'm especially excited to see they are including a section on https://mermaidviewer.com/. Visualizing API flows has always been a bit tricky for me, so learning how to do that properly will be a game-changer. Definitely considering signing up for the July session!
Will this program be repeated? I know of many tech writers who would like to acquire these skills, but I haven't found any course where a non-programmer would feel comfortable taking it. LMK, and I will be happy to let my followers know.