15:30
-
15:55
-
15:55
Day 1
How Apache Superset reinvented (and re-engineered) its world documentation
<p>The addition of a new Extensions SDK in Superset led to a new initiative: a Developer Portal.</p>
<p>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</p>
<p>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.</p>