Отсеивание новых задач/вкладок в GitHub

Данный документ показывает шаги, используемые командой AngularJS для отсеивания задач. Метки используются позже для планирования выпусков.

Автоматическая обработка

У нас есть инструменты (например, [Mary Poppins]), которые автоматически добавляют комментарии и метки к задачам и вкладкам. Следующее выполняется автоматически, поэтому вам не нужно беспокоиться об этом:

• Назначение метки cla: yes или cla: no для вкладок
• Назначение метки GH: *
  • PR — задача является вкладкой
  • issue — в противном случае

Процесс отсеиванияПроцесс основан на идеи минимизации боли пользователя из этого блога.

1. Откройте список нераспределённых проблем:

   • Сортировка по дате создания, с самыми новыми проблемами в начале списка.
   • Вы можете выбирать проблемы по своему усмотрению; вам не обязательно следовать строго порядку.
   • Также можно распределить старые проблемы.
   • Распределите проблемы по вашему усмотрению.

2. Назначьте себе задачу: Выберите проблему, которая ещё не назначена никому, и назначьте её себе.

3. Ясно ли описание? — проверьте, является ли описание запроса понятным.

   • Если нет, закройте её согласно указаниям ниже и перейдите к последнему шагу.

4. Дубликат?

   • Если вы видели эту проблему раньше, закройте её и перейдите к последнему шагу.
   • Проверьте, есть ли комментарии, которые ссылается на дубликат. Если да, проверьте, что это действительно дубликат, закройте её и перейдите к последнему шагу.

5. Ошибки:

   • Примените метку Тип: Ошибка.
   • Воспроизводится ли она? — Шаги воспроизведения ошибки чётко указаны. Если нет, попросите уточнение. Если ответа нет через неделю, закройте её.
   • Воспроизводится ли она на мастере? — http://code.angularjs.org/snapshot/

6. Не ошибки:

   • Примените метку Тип: Возможность, Тип: Улучшение или Тип: Производительность. * Подходит ли она для основной части? — Часто новые возможности должны реализовываться как сторонний модуль вместо добавления в основную часть. Если это не подходит, закройте её и перейдите к последнему шагу.
   • Примените метку необходимость: изменения в API — если требуется
   • Примените метку необходимость: публичного API — если проблема требует введения нового публичного API

7. Примените метку браузер: * — если проблема только затрагивает определённый браузер

8. Примените метку частота: * — Как часто возникает эта проблема? На сколько разработчиков она влияет? Выберите одну из следующих: * низкая — редкая проблема, затрагивающая нескольких разработчиков * средняя — затрагивает распространённый шаблон использования * высокая — затрагивает большинство или все приложения AngularJS

9. Примените метку серьёзность: * — Как серьёзна проблема? Выберите одну из следующих: * проблема безопасности * регрессия * утечка памяти * ожидаемое использование сломано — разработчику трудно или невозможно выполнить то, что должно быть возможным в AngularJS * запутанное поведение — неожиданное или несоответствующее поведение; сложно отлаживать * неудобства — вызывает некрасивый или избыточный код в приложениях

10. Примените метку компонент: * * В редких случаях допустимо иметь несколько компонентов.

11. Примените метку ПР плз!````markdown - Эти проблемы являются хорошими целями для вкладов сообщества open source. В дополнение к применению этой метки, вы должны:

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

12. Примените метку origin: google для задач, полученных от Google.

13. Назначьте этап:

    • Бэклог — отфильтрованные исправления и возможности, должны быть основным выбором по умолчанию.
    • Текущий этап 1.x.y (например, 1.3.0-beta-2) — регрессии и критически важные ошибки только.

1. Открепитесь от задачи.
```## Советы

* Тег `resolution: *`
   * Эти метки используются для маркировки закрытой задачи/PR причиной её закрытия.
   * В настоящее время существует лишь несколько причин отказа, но мы можем добавить больше при необходимости. Осмелийтесь предложить одну из них члену основной команды. Мы не используем этот тег для задач, которые были исправлены, или PR, которые были слиты.


## Закрытие задачи или PR

Мы благодарны каждому, кто уделяет время для отправки задачи, даже если в конечном итоге решено не принимать её во внимание.
Будьте доброжелательны и уважительны при закрытии задач. Убедитесь, что вы следуете [кодексу поведения][].

1. Всегда поблагодарите человека, который отправил задачу.
1. Если это дубликат, привяжите к более старой или подробной задаче, которая заменяет ту, которую вы закрываете.
1. Дайте знать, если есть какой-то способ, которым они могут продолжить работу.
   * Когда задача неясна или неповторима, отметьте, что вы снова откроете её, если они смогут прояснить ситуацию или предоставить лучший пример. Упомяните [plunker] или [fiddle] для примеров. Обратите внимание на ваши уведомления и продолжите работу, если они действительно предоставляют прояснение. :)
   * Если применимо, предложите реализовать эту функцию как сторонний модуль.Если у вас возникают сомнения, обратитесь к члену основной команды за советом.
[Брайан](https://github.com/btford) скорее всего будет тем человеком, которому стоит обратиться.
Вы можете упомянуть его в соответствующей теме следующим образом: `@btford`.**Пример:**

> Благодарю вас за отправку этой задачи!
> К сожалению, мы не считаем, что данная функциональность должна находиться в ядре.
> Хорошая новость в том, что вы легко сможете реализовать это как сторонний модуль и опубликовать его в реестре npm.


## Назначение работы

Эти критерии затем используются для расчета «оценки болезненности».
Работа назначается еженедельно членам основной команды, начиная с самой высокой оценки болезненности до самой низкой.

bolshinstvo_boli = severnost' × chastota

**severnost':**

- проблема безопасности (6)
- регрессия (5)
- утечка памяти (4)
- поломка ожидаемого использования (3)
- путаница (2)
- неудобство (1)

**chastota:**

- низкая (1)
- средняя (2)
- высокая (3)

**Замечание:** Проблемы безопасности, регрессии и утечки памяти должны почти всегда иметь значение `chastota: высокая`.


[![Аналитика](https://ga-beacon.appspot.com/UA-8594346-11/angular.js/TRIAGING.md?pixel)](https://github.com/igrigorik/ga-beacon)


[закрыть её]: #closing-an-issue-or-pr
[кодекс поведения]: https://github.com/angular/code-of-conduct/blob/master/CODE_OF_CONDUCT.md
[plunker]: http://plnkr.co/
[fiddle]: http://jsfiddle.net/