Запросы на изменение
Вопрос: Какие новые запросы на изменение исходного кода возникли в течение определенного периода?
Обзор
Метрика Change Requests отслеживает предложения по изменениям исходного кода проекта, которые были отправлены на рассмотрение в течение определенного периода времени. Эти предложения рассматриваются другими разработчиками, прежде чем изменения могут быть приняты в проект. Процесс включает в себя циклы обратной связи, где отправитель может пересмотреть свое предложение на основе предложений рецензента. Примерами являются GitHub «Pull Requests», GitLab «Merge Requests» и Gerrit «code reviews» или в некоторых контекстах «Changesets».
Отслеживание количества запросов на изменение с течением времени дает представление об общей активности кодирования в проекте. Хотя эта метрика сама по себе не может измерить качество изменений, она дает хорошее представление о том, как часто участники взаимодействуют с кодовой базой.
Хотите знать больше?
Нажмите, чтобы узнать больше об этом показателе.
Стратегии сбора данных
- GitHub:
Запрос на изменение определяется как «pull request», когда он предлагает изменения в исходных файлах кода. Дата отправки отмечает начало процесса проверки. - Гитлаб:
Запрос на изменение определяется как «запрос на слияние», когда он предлагает изменения в исходных файлах кода. Дата отправки используется для определения начала процесса проверки. - Геррит:
В Gerrit запросы на изменение называются «обзорами кода» или «наборами изменений». Отправка набора исправлений знаменует начало процесса обзора.
Фильтры
- По периоду времени: Даты начала и окончания наблюдаемого периода.
- По типу исходного кода: сузьте запросы на изменение в зависимости от типа изменяемого исходного кода.
- По субъектам: Включить фильтры на основе отправителя, рецензента или слияния запроса на изменение. Требуется слияние субъектов (слияние идентификаторов, соответствующих одному и тому же автору).
- По группам действующих лиц (работодатель, пол... для каждого из действующих лиц). Требуется группировка актеров и, вероятно, слияние актеров.
- По статусу: Фильтрация по статусу запроса на изменение (например, открытый или закрытый).
Визуализация
- Количество в месяц с течением времени:
Отображает количество запросов на изменение, отправленных каждый месяц, в формате гистограммы. - Количество по группам с течением времени:
Показывает запросы на изменение с разбивкой по группам (например, организациям) за указанный период.
Их можно представить в виде столбчатых диаграмм со временем, отсчитываемым по оси X. Каждая полоса будет представлять запросы на изменение кода в течение определенного периода (например, месяца).
-
Гримуарлаб предоставляет эту метрику из коробки для GitHub Pull Requests, GitLab Merge Requests и Gerrit Changesets.
-
Посмотреть пример на Экземпляр CHAOSS Bitergia Analytics.
-
Загрузите и импортируйте готовую панель мониторинга, содержащую примеры для визуализации этой метрики на основе данных GitHub Pull Requests из Коллекция панелей GrimoireLab Sigils.
- Пример снимка экрана:
Рисунок 1: Скриншот GrimoireLab с метрикой «Обзоры» (Grimoirelab)
-
Рекомендации
- Не указано
Соавторы
- Не указано
Дополнительная информация
- Чтобы изменить эту метрику, пожалуйста Подайте запрос на изменение здесь.
- Для ссылки на эту метрику в программном обеспечении или публикациях используйте этот стабильный URL-адрес: https://chaoss.community/?p=361.
Использование и распространение показателей работоспособности может привести к нарушению конфиденциальности. Организации могут быть подвержены рискам. Эти риски могут проистекать из соблюдения GDPR в ЕС, законодательства штата в США или других законов. Также могут быть контрактные риски, вытекающие из условий обслуживания для поставщиков данных, таких как GitHub и GitLab. Использование метрик должно быть проверено на предмет рисков и потенциальных проблем с этикой данных. Посмотри пожалуйста Документ по этике данных CHAOSS для дополнительных указаний.