How to be an Avante-Garde Guinea Pig
summary
A small support team at a 50‑person company with ~10,000 users chronicles how it turns vague docs into a repeatable program: it forms a user‑content circle, launches a site built with Sphinx, later migrates to WordPress for a central support hub, and runs a hosted forum on Insighted; experiments start with two contributors and grow to 30 contributors over 18 months, producing measurable traffic, feedback loops, contributor guidelines, and closer developer‑to‑user interactions.
AI-written summary · about
chapters (19)
- 0:00Introduction
- 1:00Avantegarde
- 1:46Documentation
- 2:47Abstract
- 3:47User Content
- 5:05Four Steps
- 5:56Build a Content Team
- 7:44Launch the Docs Platform
- 11:40Create a Support Site
- 14:53Create an Online Community
- 18:49The Result
- 21:39Takeaways
- 22:26Building the community
- 23:18Sharing the story
- 25:10Conclusion
- 25:38Squeaks Loud squeaks
- 28:23Squeak Frequency
- 31:58Slack or Teams
- 33:56How to squeak
related talks
44mFrom Me to Us: Building a docs team from the ground up
45mHow I convinced my boss to build our docs team
30mScaling external advocacy without losing your soul
29mStarting from Scratch: Finding and Hiring Junior Writers
31mProductionalizing a Data Science Team
47mFrom 0 to 300x: Lessons Learned From a Small Team Turnaround
44mSelfish Contribution
15mThe Open Source Community Core