/plushcap/analysis/mux/mux-the-building-blocks-of-great-docs

The building blocks of great docs

What's this blog post about?

The text discusses how to scale documentation as a company grows, focusing on maintaining quality content and excellent usability. It highlights the importance of information architecture and technical foundation in providing a good user experience. The author shares their experience with scaling Mux's documentation site, addressing challenges such as adding new products and features while keeping the interface manageable for users. They also discuss using Next.js 13 to improve performance by reducing JavaScript bundle sizes and adopting Tailwind CSS for better build-time CSS management. The text concludes with a comparison of metrics before and after implementing these changes, emphasizing the importance of considering user experience when scaling documentation.

Company
Mux

Date published
Jan. 20, 2023

Author(s)
Darius Cepulis

Word count
2858

Language
English

Hacker News points
24


By Matt Makai. 2021-2024.