How Apache Superset reinvented (and re-engineered) its world documentation
- Track: Tool the Docs
- Room: UD2.208 (Decroly)
- Day: Saturday
- Start: 16:30
- End: 16:55
- Video only: ud2208
- Chat: Join the conversation!
The addition of a new Extensions SDK in Superset led to a new initiative: a Developer Portal.
That, in turn, gave us the chance to re-imagine how we WANT our docs to work: • Bringing in scattered readmes/wikis/etc. under one roof • Creating independently versioned areas for different release cycles and intents • Automating screenshots and content to "keep up" with the codebase • Bringing API docs, React Story book, and more into a centralized interactive portal • Leveraging AI to build and maintain docs... for people AND for humans • Syndicating content from third party sources to be the end-all-be-all of Superset documentation • Leveraging AI (for free!) to provide chat-based support AND learn where our docs are falling short from the result
We've learned a lot of hard lessons over the years, and we're happy to share the process, ideas, and tools we've used to take things to the next level.
Speakers
| Evan Rusackas |