Scaling new heights in 2023 with Ansible Community
summary
A new, journey-based central docs site at docs.ansible.com consolidates scattered docs, moves projects under a single ansible namespace, and uses plain Markdown/YAML checked into GitHub with GitHub Pages + Actions for deployment; the team prototypes with a Nikola static generator and provides MKDocs/Sphinx themes. Community feedback via Matrix and the weekly docs working group drives iterative changes, a forum and newsletter are rolling out, and analytics already show improved discovery and clearer user paths.
AI-written summary · about
chapters (11)
- 0:00Ansible Community 2023
- 10:42Strengthening Ansible Community
- 11:23Ansible doc site disambiguation
- 14:54Documentation matters for Ansible
- 16:17User personas and needs
- 19:05User journeys for adoption
- 21:52New doc site with community feedback
- 24:40Journey-based doc site
- 26:49Future of Ansible docs
- 27:53Get involved in docs
- 28:15Q&A
related talks
44mA look at Ansible Community in 2020 - from Collections to Contributions to Conferences
36mOSS Docs and How to Scale Them: Common Themes From the CNCF Ecosystem
35mHelping Your Community Contribute to Developer Documentation
45mDocs That Scale: Strategies for Sustainable Documentation in Open Source Projects
39mOpen Docs, Open Collaboration: Building Better Documentation with Community PRs
32mBridge the Gap To OSS Adoption With Documentation: A Kubernetes Story
56mEffective Documentation: The Key to Open Source Growth
43mFOSS DOCS 101 (keep it simple, present!)