Кратко

  • В плане октября 2020 года Mozilla объяснила: прежняя вики сразу показывала правку читателям, а неподходящую правку затем отменяли. Yari переносил обсуждение и решение в запрос на изменение до публикации.
  • 14 декабря Yari запустили после испытательного периода. Документы переехали из базы SQL в файлы репозитория, но содержимое этих файлов пока оставалось HTML; главная страница, профили и поиск работали на прежней системе Django.

Публикация одной кнопкой имела оборотную сторону

Быстро исправить справочник — полезная возможность. Ошибка в описании веб-технологии может повторяться в проектах тех, кто ей доверяет. Старая вики MDN давала простой ответ: открыть встроенный визуальный редактор, изменить текст, нажать «Сохранить». Правка появлялась на открытой странице. Если она не подходила, команда могла вернуть прежнюю версию. Именно так Mozilla описала механизм в сообщении от 29 октября 2020 года.

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

За это платила и платформа. Документы хранились в MySQL; команда поддерживала историю редакций, сравнение версий и другие функции вики. Читатели и авторы проходили через одну архитектуру. Кэш CDN держал страницы пять минут, отчасти ради быстрого появления исправлений. По данным самой Mozilla, более 99% трафика приходилось на чтение документов. Требование к небольшой группе пишущих влияло на доставку страниц подавляющему большинству читающих.

Обсуждение стало отдельным этапом

Yari предлагал другой порядок. Автор менял файл в GitHub, открывал запрос, получал замечания, а после принятия изменения запускались сборка и выкладка страницы. В октябрьском плане Mozilla говорила о ежедневном выпуске и стремилась уложиться даже в худшем случае в 48 часов от предложения до появления на сайте. Это была цель до запуска, а не измеренная длительность всех последующих правок.

У такого порядка были преимущества. Спорная фраза становилась предметом обсуждения до того, как её увидит читатель документации. Один запрос мог охватывать несколько страниц, а автоматические проверки — выявлять ошибки до слияния. Команда надеялась останавливать спам до публикации и отказаться от части специального кода, обслуживавшего прежнюю вики. Для читателей готовились заранее собранные страницы. Проверка переместилась с уборки последствий к решению о допуске.

Цена перемещения была особенно заметна на маленькой правке. Встроенный визуальный редактор исчез. В интерфейсе GitHub можно было изменить файл без командной строки, но нужно было открыть запрос и дождаться решения и выкладки. Кроме того, при запуске Yari документы хранились в HTML. Переход на Markdown значился в будущих планах. Декабрьская перемена не превратила исправление страницы в лёгкое редактирование Markdown.

Переехали документы, а не весь сайт

Испытание началось 2 ноября, запуск объявили 14 декабря 2020 года. Изменения содержания теперь подавались в официальный репозиторий mdn/content. При этом главная страница, профили и поиск всё ещё обслуживались старой платформой Django. Переезд был выборочным. Сначала изменился путь документа от автора к читателю; оставшиеся части сайта продолжали работать рядом.

В июле 2021 года Mozilla сообщила о следующем шаге: аккаунты MDN больше не использовались для участия в редактировании. Нужен был вход в GitHub, а функцию аккаунтов MDN собирались отключить 22 июля. Участие осталось возможным, но вход в редакционный процесс теперь зависел от учётной записи выбранной внешней площадки.

Обе системы допускали предложения от сообщества, но давали ему разную власть. В вики участник сначала делал текст публичным, а Mozilla могла его убрать. В Yari участник сначала обосновывал предложение, а принимающий запрос решал, когда оно станет текстом MDN. Для читателя внешний вид страницы мог почти не измениться. Для человека, который нашёл ошибку, изменилось главное: кто нажимает последнюю кнопку перед публикацией исправления.