Поделиться через

Как мы управляем проблемами

В этой статье описано, как управлять проблемами в репозитории PowerShell-Docs. Эта статья предназначена как пособие для членов команды PowerShell-Docs. Мы публикуем эту информацию здесь, чтобы обеспечить прозрачность процесса для наших общедоступных участников.

Источники проблем

  • Участники сообщества
  • Внутренние участники
  • Транскрибирование комментариев из каналов социальных сетей
  • Предоставление отзывов через форму предложений по документации

Целевые показатели времени отклика

80% новых проблем решены в течение 3 рабочих дней.

  • Отсортировано - 1 рабочий день
  • Исправление или изменение — 10 рабочих дней

Маркировка & вехи

Типы меток

  • область - определяет часть PowerShell или документацию, которые обсуждаются в этой проблеме
  • проблема — тип проблемы: например, ошибка, отзывы или идея
  • приоритет — приоритет проблемы, диапазон значений 0-3 (высокий-низкий)
  • качество — улучшение качества усилия по устранению проблемы
  • состояние — состояние рабочего элемента или причины его закрытия
  • тег — используется для дополнительной классификации, например доступности или doc-a-thons
  • ожидание: Показывает, что мы ждем внешнего человека или события

Более подробные сведения о конкретных метках см. в разделе Маркировка.

Вехи

Проблемы и PR должны быть помечены соответствующей вехой. Если проблема не применяется к определенной версии, то не используется веха. PR и связанные проблемы, связанные с изменениями, которые еще не были объединены в базу кода PowerShell, должны быть назначены вехе будущего. После слияния изменения обновите веху до соответствующей версии.

Веха Описание
7.0.0 Рабочие элементы, связанные с PowerShell 7.0
7.2.0 Рабочие элементы, связанные с PowerShell 7.2
7.3.0 Рабочие элементы, связанные с PowerShell 7.3
Будущая Рабочие элементы в будущей версии PowerShell

Процесс сортировки

Участники группы документации PowerShell рассматривают вопросы ежедневно и приоритизируют новые вопросы по мере их поступления. Команда встречается еженедельно, чтобы обсудить сложные вопросы, которые нуждаются в расстановке приоритетов, и приоритизации работы.

Неуместная обратная связь о продукте

  • Введите комментарий, перенаправляющий клиента на правильный канал обратной связи.

  • Необязательно. Скопируйте проблему в соответствующее расположение отзывов о продукте, добавьте ссылку на скопированный элемент и закройте проблему.

    Расположение по умолчанию для проблем PowerShell — это https://github.com/PowerShell/PowerShell/issues/new/choose.

Запросы на поддержку

  • Если вопрос поддержки прост, ответьте на него вежливо и закройте этот вопрос.

  • Если вопрос более сложный или отправитель отвечает с дополнительными вопросами, перенаправьте их на форумы и каналы поддержки. Предлагаемый текст для перенаправления на форумы:

    > This is not the right forum for these kinds of questions. Try posting your question in a
> community support forum. For a list of community forums see:
> https://learn.microsoft.com/powershell/scripting/community/community-support

Нарушение кодекса поведения

  • При необходимости измените проблему, чтобы удалить любое оскорбительное содержимое.
  • Введите комментарий, указывающий, что проблема является спамом, закройте проблему, а затем заблокируйте ее, чтобы предотвратить дальнейшие комментарии
  • Обсудите каждое нарушение на регулярном совещании, чтобы определить, принимать ли дальнейшие меры.