Open Web Docs

Open Web Docs — это некоммерческая организация (создана в 2021 году), занимающаяся коллективным финансированием и поддержкой открытой документации по веб-платформам. Основная цель проекта — обеспечение долгосрочной устойчивости и качества технической документации для веб-стандартов, доступных всем разработчикам. Open Web Docs не является альтернативой существующим проектам, а дополняет их, предоставляя ресурсы для работы штатных технических писателей и редакторов, которые вносят вклад в такие проекты, как MDN Web Docs (ранее Mozilla Developer Network).

История и предпосылки создания

До 2020 года основным источником документации по веб-технологиям для разработчиков был проект MDN Web Docs, который развивался под эгидой Mozilla Corporation. В августе 2020 года Mozilla объявила о массовых сокращениях, в результате которых была уволена значительная часть команды, занимавшейся поддержкой MDN. Это поставило под угрозу дальнейшее развитие и актуализацию крупнейшего справочного ресурса по HTML, CSS, JavaScript и веб-API.

В ответ на эту ситуацию, в начале 2021 года группа компаний и сообществ, заинтересованных в сохранении и развитии открытой веб-документации, объявила о создании Open Web Docs. Инициаторами выступили Google, Microsoft, Mozilla, Samsung, Igalia и другие участники веб-экосистемы. Организация была зарегистрирована как некоммерческая структура в Нидерландах.

Цели и задачи

Open Web Docs ставит перед собой следующие ключевые задачи:

• Финансирование работы штатных технических писателей. Организация нанимает профессиональных авторов, которые занимаются написанием, редактированием и обновлением документации. Это решает проблему нехватки волонтёров, которая часто приводит к устареванию или неполноте информации.
• Координация вклада сообщества. Open Web Docs не управляет контентом напрямую, а координирует усилия различных компаний и независимых разработчиков, чтобы избежать дублирования работы и сосредоточиться на наиболее критических областях.
• Обеспечение нейтральности и независимости. Организация стремится к тому, чтобы документация была свободной от коммерческих интересов отдельных вендоров. Платёжные взносы членов не дают им исключительных прав на контроль над содержанием.
• Повышение качества и охвата. Приоритетными направлениями являются документирование новых веб-стандартов (например, CSS-свойств, API для прогрессивных веб-приложений), улучшение существующих статей и исправление ошибок.

Структура и управление

Open Web Docs функционирует на основе модели коллективного управления. У организации есть несколько уровней участников:

• Спонсоры (Sponsors). Компании и организации, которые вносят регулярные финансовые взносы. Среди них — Google, Microsoft, Meta (организация признана экстремистской и запрещена в РФ), Mozilla, Samsung, Igalia, Canva и другие. Спонсоры имеют представителей в управляющем комитете (Steering Committee).
• Управляющий комитет (Steering Committee). Принимает стратегические решения о распределении бюджета, найме персонала и приоритетах работы. В него входят представители спонсоров и независимые эксперты.
• Штатные писатели (Staff Writers). Профессиональные технические авторы, нанятые на полную ставку. Они являются основными исполнителями работ.
• Сообщество (Community). Любой желающий может вносить вклад в документацию через GitHub, предлагать изменения или сообщать об ошибках. Open Web Docs поддерживает и направляет этот вклад.

Отношения с MDN Web Docs

Open Web Docs не создаёт собственный сайт или базу знаний. Вся работа организации сосредоточена на улучшении MDN Web Docs, который остаётся основной платформой для размещения документации. После сокращений в Mozilla, проект MDN был передан под совместное управление Mozilla, Google, Microsoft и Open Web Docs. Таким образом, Open Web Docs обеспечивает ресурсы для поддержки контента, а Mozilla — инфраструктуру (серверы, код платформы Yari).

Ключевое различие: Open Web Docs — это организация, финансирующая труд писателей, а MDN Web Docs — это сам сайт и репозиторий с документацией. Open Web Docs не владеет и не контролирует MDN, но является его крупнейшим поставщиком контента.

Приоритетные направления работы

Работа Open Web Docs планируется на основе потребностей веб-сообщества. Основные направления включают:

• Документирование CSS. Написание и обновление справочных статей по CSS-свойствам, селекторам и функциям, особенно для новых модулей (например, CSS Grid, Subgrid, Container Queries).
• Веб-API. Документирование интерфейсов браузерных API, включая API для работы с файлами, сетью, графикой (Canvas, WebGL) и устройствами.
• Доступность (Accessibility). Создание и улучшение руководств по созданию доступных веб-интерфейсов.
• Прогрессивные веб-приложения (PWA). Документирование технологий, позволяющих веб-сайтам работать как нативные приложения (Service Workers, Web App Manifest).
• Обучение и руководства. Разработка учебных материалов для начинающих разработчиков (например, раздел «Learn web development» на MDN).

Влияние и критика

Open Web Docs считается успешным примером коллективного управления открытой инфраструктурой. Благодаря её работе, MDN Web Docs продолжает активно обновляться, несмотря на уход Mozilla из этой сферы. Организация обеспечила стабильное финансирование для 3-5 штатных писателей, что позволило сократить отставание документации от развития браузеров.

Критика в адрес Open Web Docs в основном связана с вопросами управления. Некоторые члены сообщества выражали опасения, что крупные спонсоры (Google, Microsoft) могут оказывать непропорциональное влияние на приоритеты, хотя формально управляющий комитет стремится к консенсусу. Также отмечалось, что организация сфокусирована в основном на MDN, и её вклад в другие проекты открытой документации (например, WHATWG, W3C) остаётся ограниченным.

Источники

• Официальный сайт Open Web Docs
• Блог Mozilla Hacks: «Open Web Docs: A new collaborative project for web documentation»
• Репозиторий Open Web Docs на GitHub
• Статья «The State of Web Documentation» на сайте CSS-Tricks