Наши рецензенты Базы Знаний являются участниками и сотрудниками Mozilla, которые имеют опыт и навыки написания вспомогательной документации. Вот несколько рекомендаций для рецензирования статей.
Оглавление
Рецензирование статей
Большинство изменений вносятся людьми, которые добровольно вкладывают своё время и талант. Имея дело с работой, которую предоставили людьми, предположите, что у каждого есть наилучшие намерения, и обязательно поблагодарите их за их вклад. Помните, вы можете быть первым и единственным контактом этого человека с кем-то из Mozilla. Пожалуйста, сделайте это положительным.
В Обзорной информационной панели Базы Знаний перечислены статьи в порядке посещений за последние 30 дней. В столбце Состояние будет показано, какие статьи необходимо просмотреть. Все изменения должны быть рассмотрены своевременно, а не только топ-статьи. Список Неотрецензированные изменения - это альтернативный способ узнать, какие статьи должны быть рассмотрены и какие изменения ожидали рецензии в течение самого длительного периода времени (вы можете отсортировать список по "самым последним" и работать снизу).
Топ статей
На наши главные статьи (более 100 000 посещений в месяц, около 20 статей для ПК) приходится около 50-55% всех посещений базы знаний. Наши лучшие статьи для Android - это те, которые посещают более 5,000 человек в месяц.
Очень важно, чтобы в этих статьях была самая свежая информация.
- Для обновлений существующего содержимого - вы можете утвердить все ревизии (включая вашу собственную), которые, по вашему мнению, улучшат статью.
Поскольку главные статьи могут быть отредактированы и затронуть большое количество людей, сначала необходимо обсудить большие изменения в статье. Не стесняйтесь обращаться в личных сообщениях к другим участникам базы знаний, чтобы попросить их присоединиться. Лучше всего достичь единого мнения, хотя иногда это трудно сделать. Как всегда, воспользуйтесь своим лучшим мнением.
- Для больших изменений — пожалуйста, обсудите их на форуме, прежде чем одобрить их. Не одобряйте вашу собственную ревизию, если это большое изменение. (Если у вас была открытая дискуссия в течение как минимум 36 часов без возражений, вы можете утвердить её самостоятельно, если вы довольны своей работой.)
Другие статьи
Статьи с менее 100 000 посещений в месяц для ПК (или с менее чем 5,000 посещений для Android) представляют собой подавляющее большинство нашей Базы Знаний (около 600+ статей; 45-50% посещений). Они охватывают менее распространенные проблемы и новые продукты. Здесь политика обзора более мягкая.
- Утвердите все ревизии и большие изменения (включая ваши собственные), которые, по вашему мнению, улучшат статью.
Новые статьи
Когда мы впервые создаём статью, у неё вообще нет посещений. Так как вы относитесь к этому?
- Если статья создаётся для специального назначения (выпуск для Firefox, для ссылки из продукта или из mozilla.org) или является готовым ответом, относитесь к ней как к одной из лучших статей.
- Если у нас нет никаких оснований полагать, что статья сразу станет очень популярной, относитесь к ней, как к другим статьям с менее чем 100,000 посещений в месяц для ПК версии или 5,000 посещений в месяц для Android. Если ревизия является улучшением, утвердите её. Это нормально, если статья не завершена на 100%. Если это не одна из лучших статей, она может начать собирать отзывы, когда над ней ведутся работы.
- После того, как новая статья была одобрена, но была опубликована менее месяца, рассмотрите возможность просмотра 7 дней.
Специальные статьи
- Ответы для форума гораздо важны на Форуме Поддержки, чем для количества просмотров. Относитесь к новым статьям или чему-либо большему, чем незначительное исправление или уточнение, как к большому изменению. Прочитайте статью Создание или улучшение общих ответов на форуме для получения дополнительных рекомендаций.
Что такое обновление существующего содержимого?
Самая распространённая задача в Базе Знаний - поддерживать статьи в актуальном состоянии. Обычно это включает в себя:
- Правописание и грамматические исправления
- Упрощение существующего языка, удаление жаргона
- Обновление или добавление скриншотов
- Обновление или добавление скринкастов
- Удаление содержимого для версий Firefox, которые мы больше не поддерживаем
- Обновление пошаговых инструкций для поддержки новых версий Firefox
- Обновление существующего текста для поддержки изменений в новых версиях Firefox
- Исправление проблем с вики-разметкой
- Исправление ссылок
- Обновление ключевых слов
- Добавление или обновление результатов поиска
Что такое большое изменение?
Большие изменения - изменения, которые фундаментально изменяют существующую статью. Они включают:
- Добавление нового раздела
- Удаление существующего раздела
- Обширное переписывание (больше, чем упрощение и удаление жаргона)
- Перезапись заголовков разделов
- Изменение порядка разделов
- Изменение объема статьи
Уровни ревизий
Когда вы утверждаете статью, у вас есть три различных уровня редакции:
- Незначительные детали, которые не влияют на инструкции: это изменения, которые не изменят инструкции для пользователей. Переводчики не будут уведомлены об этих изменениях.
- Изменения содержимого, которые не требуют немедленного перевода: это выбор по умолчанию. Это значительные изменения (обновления и большие изменения), которые полностью не отменяют предыдущую версию статьи.
- Значительные изменения содержимого, которые сделают старые переводы недействительными: это редкий случай, когда статья настолько неправильна, что без этих изменений это вызовет серьёзные проблемы у пользователей. Это добавит предупреждение для переведённых статей о том, что содержание может быть устаревшим, и предоставит ссылку на английскую версию.
Обратная связь для редакторов
При утверждении статьи важно поблагодарить редакторов за их вклад. Также хорошо, если вы можете дать им обратную связь. Их написание статей улучшилось? Они сделали особенно хорошую работу, объясняя что-то сложное? Пусть они знают!
Если ревизия содержит больше, чем просто ошибку, является большим изменением в главной статье, которая не обсуждалась, или является чем-то, что вы не считаете полезным, вам следует отложить одобрение. Однако вместо того, чтобы быть просто отклонить, сделайте отсрочку - это ваша возможность работать с редактором, чтобы подготовить эту ревизию к утверждению. Поэтому, пожалуйста, поблагодарите редактора, а затем дайте конкретную конструктивную обратную связь о том, что, по вашему мнению, необходимо изменить, чтобы редакция была приемлемой. В дополнение к полю комментария при переносе редакции вы также можете добавить тему на форум обсуждения статьи с более подробной информацией и направить редактора на форум обсуждения статьи. Не забудьте дать ему/ей ссылки на любые соответствующие обсуждения статьи или руководящие рекомендации.
Готово к локализации
Отмечая ревизию статьи как "Готова к локализации", мы можем сообщить переводчикам, что ревизия на английском языке готова, и её можно переводить, не опасаясь, что статья изменится еще несколько раз, прежде чем она будет готова.
Если вы утверждаете ревизию, если все необходимые изменения (примечания к выпуску, форум для обсуждения статей) уже выполнены, а другие не запланированы на текущий или следующий выпуск, отметьте статью как готовую к локализации.
Локализация - это большая работа, которая часто выполняется одним человеком. Только лучшие 20, или около того, статей переводятся в некоторых регионах. Наши главные статьи обычно не нуждаются в каких-либо изменениях, кроме обновлений для новой версии Firefox. Поскольку мы знаем, что произойдет, мы стараемся убедиться, что все необходимые изменения внесены до выпуска Firefox, чтобы переводчики могли использовать это дополнительное время для выполнения своей работы.
Если при утверждении вы не помечаете ревизию как готовую к локализации (как в случае выше), вы можете пометить её как готовую, щёлкнув на статус в записи истории ревизии и подтвердив его.
Как работает "Готов к локализации" (RFL)?
Чтобы никто не переводил статью в потоковом режиме, когда вы нажимаете "Перевести статью", вам предоставляется самая последняя версия, помеченная как готовая к локализации. После утверждения новой редакции статьи она не добавляется на информационную панель локализации, поскольку для неё требуется обновление, если только редакция не помечена вторым или третьим уровнем редакции и не установлена пометка готовности к локализации. Это также отправляет уведомление по электронной почте всем, кто следит за статьями, которые готовы к локализации.
Содержание следующего выпуска
Статьи с содержанием следующего выпуска - это либо новые статьи, либо изменения содержимого существующих статей, которые охватывают функциональные возможности, представленные в следующем выпуске. Следующие рекомендации применимы к статьям с содержанием, связанным с выпуском:
Временная шкала редактирования Базы Знаний на основе выпуска (кодовое имя: RocKET)
6 недель до следующего выпуска / 1 неделя после текущего выпуска
- Нет работы над следующим выпуском содержимого для английского языка; мелкие исправления для существующего английского содержимого; пожалуйста, избегайте установки отредактированных статей в RFL, если это не критично (обратитесь к Joni или другому администратору).
- Переводчики заканчивают локализацию содержимого и исправляют возможные проблемы, возникающие в последнюю минуту, с содержимым выпуска - это имеет приоритет над другим существующим содержимым (= не текущий выпуск), который может быть локализован как обычно.
5 недель до следующего выпуска / 1 неделя после текущего выпуска
- Нет работы над следующим выпуском содержимого для редакторов Базы Знаний или локализаторов
- Весь существующий контент открыт для редактирования и локализации как обычно; пожалуйста, обратите внимание на локализацию самого последнего/популярного содержимого.
За 4 недели до следующего выпуска / 2 недели после текущего выпуска
- Joni начинает планирование и составление содержимого для следующего выпуска; для следующего выпуска пока нет работы для переводчиков.
- Весь существующий контент открыт для редактирования и локализации как обычно; пожалуйста, обратите внимание на локализацию самого последнего/популярного содержимого.
За 3 недели до следующего выпуска / через 3 недели после текущего выпуска
- Joni заканчивает работу над содержанием следующего релиза к концу этой недели; для следующего релиза пока нет работы для переводчиков.
- Весь существующий контент открыт для редактирования и локализации как обычно; пожалуйста, обратите внимание на локализацию самого последнего/популярного содержимого.
За 2 недели до следующего выпуска / через 4 недели после текущего выпуска
- Только Joni или другие администраторы могут вносить и/или утверждать возможные изменения в последний момент в содержимое следующего выпуска; только Joni или другие администраторы могут устанавливать новое содержимое в RFL; переводчики должны сосредоточиться на этом содержимом.
- Всё другое существующее содержимое удалено из списка, но может быть отредактировано и переведено как обычно.
За 1 неделю до следующего выпуска / 5 недель после текущего выпуска
- Только Joni или другие администраторы могут вносить и/или утверждать возможные изменения в последний момент в содержимое следующего выпуска; только Joni или другие администраторы могут устанавливать новое содержимое в RFL; переводчики должны сосредоточиться на этом содержимом.
- Всё другое существующее содержимое удалено из списка, но может быть отредактировано и переведено как обычно.
Требуются изменения
При утверждении ревизии вы должны решить, что может быть что-то ещё нужно изменить. Если всё, что указано в комментарии "Требуются изменения", было выполнено, вы можете снять флажок (очистить комментарий) и одобрить статью. Если есть ещё вещи, которые необходимо сделать, убедитесь, что флажок установлен и следует обновить комментарий. Таким образом, мы можем легко отслеживать, какую работу необходимо выполнить над статьями.
Добавление помощников
Иногда люди, которые участвуют в обсуждении статьи, вносят значительный вклад в редактирование, даже если они не были теми, кто действительно редактировал вики. В таких случаях вы можете отредактировать список авторов статьи (на странице истории статьи), чтобы включить их. Бонусные баллы за то, что они знают, что вы сделали это!
Спам и ошибочные правки
В случае спама вы должны просто удалить ревизию (нажмите "X" в её записи в истории просмотра). В случае ошибочной правки (без изменений) и неуместных запросов о помощи (редактирование в основном является вопросом поддержки), вам следует отложить и включить это сообщение в свои комментарии:
Привет.
Похоже, вы пытались получить помощь с Firefox. Если это так, пожалуйста, задайте свой вопрос еще раз здесь, https://support.mozilla.org/questions/new, чтобы мы могли лучше помочь вам.
Извините за доставленные неудобства.
После этого вы можете удалить ревизию.
На страницах en-US , Х, чтобы удалить ревизию, находится на следующей строке.