How AsyncAPI Docs Got a Facelift: GSoD 2022 Contributions
summary
AsyncAPI docs get a concrete overhaul: an Information Architecture replaces the old menu with five content buckets (concepts, tutorials, guides, reference, tools), UML-style diagrams integrated into concept pages, and tutorials restructured around four actions (create AsyncAPI document, validate document, generate code, validate events). GSoC 2022 draws 200+ applicants and produces six interns who authored concept pages, rewrote tutorials, and implemented the new docs homepage; work continues through November to hit 90% spec-term coverage.
AI-written summary · about
chapters (12)
- 0:00Introduction
- 0:39Presentation Overview
- 1:39Where to Find Us
- 2:57Agenda
- 4:35Interview Process
- 10:10The Candidates
- 11:48New Information Architecture
- 14:42Tutorial vs Guide
- 18:58Docs Home Page
- 20:53Tutorial Changes
- 22:59Future Goals
- 25:10Conclusion
related talks
43mHow to contribute to AsyncAPI Dev Docs
21mMy Onboarding Experience as a New Docs Contributor to AsyncAPI
19mDesigning Trust: How to improve API Adoption & Developer Experience
26mContributing to AsyncAPI from a Technical Writer’s POV
29mThe Power of Ecosystem Thinking: Cultivating AsyncAPI Docs Community
13mEffortlessly Generating Docs with AsyncAPI
12mGSoC: Writing the spec document without knowing the specification
27mThe State of AsyncAPI