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

Маркировка в GitHub

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

Метки всегда имеют имя и описание, которое префиксируется с их типом.

Метки области

Метки областей определяют части PowerShell или документацию, к которым связана проблема.

Этикетка Связанный контент
area-about Статьи about_* .
area-archive Модуль Microsoft.PowerShell.Archive.
area-cim Модуль CimCmdlets.
area-community Проекты, ориентированные на сообщество, включая руководство для участников и ежемесячные обновления.
area-conceptual Концептуальные статьи (а не справочник по командлетам).
area-console Консольный хост
area-core Модуль Microsoft.PowerShell.Core.
area-crescendo Модуль Crescendo.
area-debugging Отладка PowerShell.
area-diagnostics Модуль Microsoft.PowerShell.Diagnostics.
area-dsc Конфигурация требуемого состояния PowerShell.
area-editorsvcs Службы редактора PowerShell.
area-engine Подсистема PowerShell.
area-error-handling Обработка ошибок в PowerShell
area-experimental Экспериментальные функции PowerShell
area-gallery Коллекция PowerShell.
area-helpsystem Справочные службы, включая конвейер и командлеты *-Help.
area-host Модуль Microsoft.PowerShell.Host.
area-ise PowerShell ISE.
area-jea Функция "Достаточное администрирование".
area-language Синтаксис и ключевые слова PowerShell.
area-learn Структурированный учебный материал для PowerShell.
area-localaccounts Модуль Microsoft.PowerShell.LocalAccounts.
area-localization Проблемы локализации или возможности для содержимого.
area-management Модуль Microsoft.PowerShell.Management.
area-native-cmds Использование собственных команд в PowerShell.
area-omi Открытая среда управления & CDXML.
area-ops-issue Создание и отображение содержимого на сайте.
area-other Другие модули.
area-overview Раздел обзора в разделе концептуального содержания.
area-packagemanagement Модуль PackageManagement.
area-parallelism Содержимое, охватывающее параллельную обработку, например использование ForEach-Object или заданий PowerShell.
area-platyps Модуль PlatyPS.
area-portability Кроссплатформенная совместимость.
area-powershellget Модуль PowerShellGet.
area-providers Поставщики PowerShell.
area-psreadline Модуль PSReadLine.
area-release-notes Заметки о выпуске PowerShell.
area-remoting Функция удаленного управления и командлеты PowerShell.
area-scriptanalyzer Модуль PSScriptAnalyzer.
area-sdk-docs Концептуальная документация по пакету SDK PowerShell.
area-sdk-ref Справочная документация по API .NET для SDK PowerShell.
area-security Модуль Microsoft.PowerShell.Security и концепции безопасности в целом.
area-setup Установка и настройка PowerShell.
area-threadjob Модуль ThreadJob.
area-utility Модуль Microsoft.PowerShell.Utility.
area-versions Проблемы с версией документации.
area-vscode Расширение VS Code PowerShell.
area-wincompat Функция совместимости Windows.
area-wmf Платформа управления Windows.
area-workflow Компонент рабочего процесса Windows PowerShell.

Метки задач

Метки проблем используются для различения их по назначению.

Этикетка Категория проблемы
issue-doc-bug Ошибки или неоднозначность в содержимом
issue-doc-idea Запросы на новое содержимое
issue-kudos Похвала, положительный отзыв или благодарность вместо рабочих заданий
issue-product-feedback Обратная связь или проблемы с самим продуктом
issue-question Вопросы о поддержке

Метки приоритета

Метки приоритета определяют, над какими рабочими элементами необходимо работать в первую очередь. Эти метки используются только при необходимости для управления большими наборами рабочих элементов.

Этикетка Уровень приоритета
Pri0 Самый высокий
Pri1 Высоко
Pri2 Средний
Pri3 Низкий

Метки проекта

Метки проекта указывают, с каким рабочим элементом связан текущий проект GitHub. Эти метки используются для автоматического добавления рабочих элементов в проект при создании.

Этикетка Проект
project-quality Проект по улучшению качества

Метки качества

Метки качества классифицируют рабочие элементы для повышения качества в рамках инициативы.

Этикетка Улучшение
quality-aliases Убедитесь, что псевдонимы командлетов документируются
quality-format-code-samples Настройка правильного регистра, длины строк и другого форматирования в примерах кода
quality-format-command-syntax Обеспечение правильного регистра и форматирования для синтаксиса команды
quality-link-references Убедитесь, что ссылки в концептуальных документах определяются как нумеровые ссылки
quality-markdownlint Убедитесь, что содержимое соответствует правилам markdownlint
quality-spelling Убедитесь в правильности регистра и орфографии слов

Статусные метки

Метки состояния указывают, почему рабочий элемент был закрыт или не должен быть объединен. Проблемам присваиваются метки состояния только в случае их закрытия без связанного pull request.

Этикетка Состояние
resolution-answered Закрыто на основании существующей документации
resolution-duplicate Закрыта как повторяющаяся проблема
resolution-external Закрыто клиентом или внешним ресурсом
resolution-no-repro Не удалось воспроизвести сообщаемую проблему
resolution-refer-to-support Закрыто и передано в службу поддержки сообщества или продукта
resolution-wont-fix Закрыто, так как не будет исправлено

Метки тегов

Метки тегов добавляют независимый контекст для рабочих элементов.

Этикетка Цель
in-progress Кто-то активно работает над элементом
go-live Рабочий элемент связан с соответствующим выпуском
doc-a-thon Рабочий элемент связан с мероприятием по созданию документации (doc-a-thon)
up-for-grabs Любой участник может по собственной инициативе разрешить задачу
hacktoberfest-accepted PR принята для включения в #hacktoberfest
hacktoberfest-candidate PR является кандидатом на включение в #hacktoberfest
needs-triage Проблема должна быть приоритизирована командой, прежде чем её можно будет решить.
code-of-conduct Закрыто для нежелательной почты, троллинга или кодекса нарушений поведения
do-not-merge PR не предназначен для объединения

Метки ожидания

Метки ожидания указывают, что рабочий элемент не может быть решён до тех пор, пока не будет выполнено внешнее условие.

Этикетка В ожидании
hold-for-pr Upstream PR для объединения
hold-for-release Выпуск предварительного продукта
needs-investigation Ожидание того, чтобы участник группы проверял или исследовал
needs-more-info Дополнительные сведения или уточнение от автора рабочего элемента
needs-response Ответ автора рабочего элемента
review-shiproom Обсуждение выпуска с командой разработчиков PowerShell