Триажирование и курирование проблем#
В SciPy есть сотни открытых проблем. Закрытие недействительных и правильная маркировка действительных (желательно с некоторыми первоначальными мыслями в комментарии) позволяет приоритизировать работу по обслуживанию и легко находить связанные проблемы при работе над существующей функцией или подпакетом.
Хотя любой может комментировать и предоставлять дополнительную информацию по открытым проблемам, дополнительные разрешения требуются, если вы хотите применять метки к проблемам в репозитории SciPy. Хотя формального процесса получения прав на триажирование нет, ожидается, что человек должен быть активным участником, прежде чем присоединиться к команде.
Роли и разрешения#
SciPy использует два уровня разрешений: триаж и члены основной команды. Участники триажа может маркировать и закрывать issues и pull requests, в то время как поддерживающие может маркировать и закрывать issues и pull request, а также объединять pull requests.
Улучшение проблем#
Описания проблем могут быть неполными, неточными или устаревшими. Никаких специальных разрешений не требуется для работы над их улучшением - это может быть полезно и помочь уменьшить нагрузку на сопровождающих и других участников. Следующие действия обычно полезны:
документирование проблем, в которых отсутствуют элементы для воспроизведения проблемы, такие как примеры кода
предлагая переформулировать заголовок и описание, чтобы сделать их более явными относительно решаемой проблемы
ссылаясь на связанные проблемы или обсуждения, кратко описывая, как они связаны, например, «См. также #xyz для аналогичной попытки» предоставляет контекст и помогает обсуждению.
Помните, что каждый комментарий к issue или pull request создает уведомление для группы людей. Будьте внимательны и используйте кнопку редактирования комментария при необходимости.
Плодотворные обсуждения#
Онлайн-обсуждения могут быть сложнее, чем кажется на первый взгляд, особенно учитывая, что новичок в open-source может иметь совершенно иное понимание процесса, чем опытный сопровождающий.
В целом, полезно сохранять позитивный настрой и предполагать добрые намерения. Эта статья рассматривает, как проводить онлайн-обсуждения в контексте открытого исходного кода. Также важно помнить, что все взаимодействия должны соответствовать Кодекс поведения SciPy.
Метки задач (требуются права на триаж)#
При создании issue или pull request, SciPy может автоматически назначить одну или несколько меток в зависимости от заголовка или раздела кода. Например, все issues, созданные с заголовком, включающим BUG: префикс автоматически получит defect метка.
В некоторых случаях может быть полезно также вручную добавить другие метки. Любой человек с правами триажа может добавлять или удалять метки по мере необходимости. Проверьте полное описание текущих меток для получения дополнительной информации.