Contributing to AsyncAPI from a Technical Writer’s POV
summary
Notes a mentorship path into contributing docs for AsyncAPI, handling 25 messy commits that require squashing, navigating a sprawling GitHub repo and YAML workflows, and consolidating duplicated content — e.g., merging two Slack-etiquette pages into five cleaned contributor guides and removing a redundant GitHub Actions workflow table in favor of inline YAML comments. Describes learning to accept feedback, improve async communication and Git hygiene, and becoming a program co-lead.
AI-written summary · about
chapters (9)
- 0:00Introduction
- 1:06Why AsyncAPI contributions
- 4:39AsyncAPI mentorship program
- 7:29Writer contribution challenges
- 11:21Learning Git/GitHub
- 13:54Avoiding doc duplication
- 16:47Skills gained in mentorship
- 20:26Future community plans
- 21:54Q&A
related talks
43mHow to contribute to AsyncAPI Dev Docs
21mMy Onboarding Experience as a New Docs Contributor to AsyncAPI
28mHow AsyncAPI Docs Got a Facelift: GSoD 2022 Contributions
13mEffortlessly Generating Docs with AsyncAPI
35mFrom Code to Clarity: Collaboration with Devels when Writing Product Documentation
48mBeyond Words: Crafting User-Friendly Documentation
36mAgile documentation: A first class citizen
56mEffective Documentation: The Key to Open Source Growth