Company
Date Published
Author
Jonny Summers-Muir
Word count
1002
Language
English
Hacker News points
3

Summary

The author of this text, a developer at Supabase, shares the challenges they faced with their documentation tool, which was previously powered by Docusaurus. The main issue was that the tool's complexity and lack of integration with other parts of the platform made it difficult to contribute to and maintain. To address this, the team decided to migrate to Next.js, a unified frontend stack, and built an MVP (minimum viable product) documentation site. This new release adds several features, including a new design, better navigation, and improved reference docs. The author hopes to build on this foundation by re-imaging what a documentation experience can be, with plans for fully integrated experiences, auto-generated documentation, and interactive tutorials.