Mozilla полностью переписала фронтенд MDN Web Docs — под капотом нового справочника
Главный справочник по веб-технологиям получил новый фронтенд. Команда Mozilla объясняет, зачем переписали MDN, какие технологии выбрали и что получилось.
Если вы регулярно заглядываете в MDN Web Docs — вы уже видите результат: сайт полностью переписан. Команда Mozilla объясняет, почему решились на ребилд, какие технологии выбрали и что получили.
MDN Web Docs — главный справочник по веб-технологиям для миллионов разработчиков. Документация по HTML, CSS, JavaScript, Web API и HTTP, которую используют все — от новичков до авторов браузерных движков.
Ключевые выводы
- Mozilla полностью переписала фронтенд MDN Web Docs
- Команда объясняет архитектурные решения, выбор технологий и причины ребилда
- MDN остаётся главным справочником по веб-технологиям с миллионами пользователей в месяц
- Обновление затрагивает навигацию, поиск и общую производительность сайта
Зачем переписывать
MDN обслуживает миллионы разработчиков ежемесячно, и фронтенд-стек не обновлялся существенно с момента последней крупной миграции. С ростом контента и аудитории накопился технический долг: медленная навигация, устаревшие зависимости, сложность внесения изменений.
Команда приняла решение переписать фронтенд с нуля, сохранив весь контент (который хранится в markdown-репозитории mdn/content на GitHub).
Что изменилось
- Навигация — переработана структура меню и боковая панель для более быстрого доступа к документации
- Поиск — улучшен поиск по всему корпусу документации
- Производительность — оптимизирована загрузка страниц и рендеринг
- Дизайн — обновлённый визуальный язык при сохранении узнаваемого стиля MDN
Почему это важно для веб-разработчиков
MDN — не просто документация. Это стандарт де-факто для поиска ответов о веб-API. Когда Google показывает фрагмент из MDN в результатах поиска — он берёт данные именно с этого сайта. Обновление фронтенда означает, что ежедневный инструмент миллионов разработчиков стал быстрее и удобнее.
Для тех, кто контрибьютит в MDN (а это открытый проект — контент на GitHub), обновление фронтенда не влияет на процесс написания документации: контент остаётся в markdown, а фронтенд — отдельный слой рендеринга.
Частые вопросы
Изменился ли контент MDN?
Нет. Обновление затронуло только фронтенд — то, как документация отображается. Весь контент (тексты, примеры кода, таблицы совместимости) остаётся прежним и хранится в отдельном репозитории.
На каком стеке теперь MDN?
Подробности архитектуры — в блог-посте команды на developer.mozilla.org/blog. Фронтенд MDN (репозиторий mdn/yari) — открытый проект, детали нового подхода описаны в статье.
Можно ли контрибьютить в MDN?
Да. Контент MDN — open source на GitHub (mdn/content). Можно исправлять ошибки, добавлять примеры, переводить документацию. Фронтенд-код также открыт в репозитории mdn/yari.
Подробности: блог MDN Web Docs.
