It requires an ample amount of time, effort, and resources to produce great, user-friendly documentation. Good documentation is fundamental to the way engineers get started with a product and ultimately use it in the long run, which makes it essential to both user retention and growth. Building our documentation at Courier was a task we, therefore, took very seriously.

We originally created our documentation for a very small, specific audience with specific uses for Courier. Over time, however, as our user base, their use cases, and our product itself has grown, we needed to improve and expand our documentation in order to cover our bases. This time, we wanted to make it scalable and focus on a great user experience. We decided to use Docusaurus to do so, which allowed our engineers to collaborate and update our documentation more efficiently. Here’s how we built our documentation and what we learned in the process that might be useful to you.