We Designed TigerBeetle's Docs from Scratch

We recently rebuilt TigerBeetle’s docs site from scratch. We wanted to apply TigerStyle and first principles thinking, not only to our database but also to our docs. To give users the fastest possible experience, given how much time they spend reading, and to do this without the dependency of Docusaurus. At TigerBeetle, how we build things is as important as what we build, because methodology has a second order effect on motivation. When TigerBeetle was founded, Docusaurus was used to prototype our docs site. It was quick to start, and we could maintain our docs in our main GitHub repository. There were, however, some downsides: Violation of our zero dependency principle: as Docusaurus is based on NodeJS, it added a lot of dependencies to our code base. We have a check that no large files are committed to git, and package-lock.json failed this check. Complexity: Docusaurus is fundamentally a complex piece of software – a React app. While it’s good at what it does, we believe that a ... Read full article.