How to contribute to AsyncAPI Dev Docs
summary
AsyncAPI documents currently reorganize into five content buckets (tutorials, how‑tos, reference, concepts, tools) using the Diátaxis method; the site has 100k+ unique visitors and 150+ GitHub contributors. Contribution workflow: open an issue in the website repo, get approval, open a PR, and merged doc changes docs auto-publish to the live site. Tasks available include writing protocol-specific tutorials (WebSocket), moving README content from tool repos into the docs site, and picking issues from the public projects board or GitHub discussions.
AI-written summary · about
chapters (15)
- 0:00Introduction
- 1:32Screenshare
- 1:53Why am I here
- 4:03Linux Foundation
- 8:32Community
- 10:33Public Meetings
- 12:13Agenda
- 13:58Current State
- 15:11User Experience
- 17:14Framework
- 23:07Content Buckets
- 24:24Conceptual Explanation
- 26:02Contribution Guide
- 32:04Community Feedback
- 34:36Community Contributions
related talks
26mContributing to AsyncAPI from a Technical Writer’s POV
28mHow AsyncAPI Docs Got a Facelift: GSoD 2022 Contributions
22mHow Contributing to AsyncAPI Tools Inspired a Career in OSS
21mMy Onboarding Experience as a New Docs Contributor to AsyncAPI
35mHelping Your Community Contribute to Developer Documentation- 22mHow Contributing to AsyncAPI Tools Inspired a Career in OSS
13mEffortlessly Generating Docs with AsyncAPI
25mThe State of AsyncAPI Initiative