Дока — справочник веб-разработчика

Что это

Дока — бесплатный русскоязычный справочник для веб-разработчиков. Сами авторы называют его «добрым справочником», и это хорошо передаёт тон: статьи написаны простым языком, без канцелярита и без перевода с английского через силу. Справочник открытый: и тексты, и код сайта лежат на GitHub, а писать статьи может любой, кто разбирается в теме.

Материал разложен по разделам: HTML, CSS, JavaScript, «Веб-платформа», «Доступность» и «Рецепты». В первых трёх — статьи по конкретным тегам, свойствам и конструкциям языка, от <div> и семантики HTML до каскадных слоёв @layer и Web Workers. В «Рецептах» — готовые решения практических задач, например загрузка файла на сервер с прогресс-баром. Есть и обзорные материалы: большой гайд по гридам, статья о структурах данных в JavaScript, разбор того, как оценивать сложность алгоритмов.

Идея проекта родилась в Яндекс Практикуме в 2019 году, как самостоятельный проект Дока запустилась 12 октября 2021 года. Сейчас её ведёт редакция из нескольких человек — у каждого раздела свой редактор — и сообщество авторов.

Почему мы это выбрали

Хорошей документации по вебу на русском не так много. MDN частично переведён, но переводы отстают и местами читаются тяжело. Дока не переводит, а объясняет заново: каждая статья начинается с короткого «кратко», дальше идёт пример, а потом — подробности и подводные камни. Многие статьи заканчиваются блоком «На практике», где опытные разработчики делятся тем, как применяют приём в работе, — для новичка это едва ли не самая ценная часть.

Отдельно нравится раздел о доступности. Обычно о ней вспоминают в последнюю очередь, а здесь это полноценная часть справочника: что такое изменяющиеся области, как озвучиваются элементы, как не сломать сайт для людей с экранными читалками. Ещё приятная деталь — свои обложки-иллюстрации у статей: справочник выглядит не как сухая техническая документация.

С чего начать

• Откройте статью про const, let и var, если только знакомитесь с JavaScript: это хорошее введение в то, как устроены статьи.
• Прочитайте «Гайд по grid» — полный список свойств для раскладки на гридах в одном месте, удобно держать открытым во время вёрстки.
• Загляните в «Что такое семантика?» в разделе HTML, чтобы понять, зачем нужны правильные теги.
• Полистайте «Рецепты»: там готовые решения задач, которые встречаются в каждом втором проекте.
• Нашли ошибку или хотите написать статью — на GitHub есть инструкция для авторов.

Кому подойдёт

Тем, кто учится фронтенду и хочет читать объяснения на родном языке. Действующим разработчикам — как быстрая шпаргалка, когда нужно вспомнить синтаксис или проверить, как ведёт себя свойство. Преподавателям и наставникам — как источник, на который не стыдно дать ссылку студенту. И тем, кто хочет попробовать себя в техническом письме: открытый проект с редакторами — хорошая школа.

Коротко о главном

Дока бесплатная? Да, все материалы открыты и доступны без регистрации, а исходники лежат на GitHub.

Это перевод MDN? Нет, статьи пишутся заново, своим языком и со своими примерами.

Можно ли стать автором? Да, проект открыт для участия: можно написать статью, предложить правку или помочь с самой платформой.