2024 · Документация

Project Cara

Документация для open-source инструмента.

Open-source инструмент терял контрибьюторов: документация старела быстрее, чем её правили. Сайт был кастомным PHP, который никто не хотел расширять.

Почему

Барьером была платформа, не текст.

Как

Astro + MDX. Шаг сборки прогоняет примеры через реальную библиотеку на каждом PR.

Результат

Сборка 240 страниц — 30 секунд. Контрибьюторы перестали извиняться перед PR в docs.