1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/linuxsuren-open-source-best-practice

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
good-first-issue.md 5.6 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 07.03.2025 23:59 4ef9e6d

Открытый проект имеет включающую группу участников, которая приобретает форму обратной пирамиды.

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

Есть также участники с меньшим количеством коммитов, но всё же активно участвующие в проекте; таких участников тоже достаточно много, что можно рассматривать как средний уровень пирамиды.

Наибольшая часть состоит из участников, делающих единичные или небольшие вклады. Именно эти "гости" являются теми, кто сейчас находится в центре внимания:

  • Каждый значимый участник начинал как "гость", поэтому увеличение численности и качества участников следует начинать именно здесь
  • Непрерывный поток новых "гостей" помогает создать видимость процветания проекта
  • Доброжелательность к новым участникам является одним из показателей зрелости открытого проекта

Также возникает вопрос: какие issues могут быть помечены как good-first-issue? По буквальному смыслу, это задачи, предназначенные для новых участников (впервые взаимодействующих с проектом), то есть те задачи, которые легче всего решаются такими участниками.

Поэтому, чтобы определить, стоит ли помечать конкретный issue как good-first-issue, можно рассмотреть следующие аспекты:1. Как определяются "новички"?

  1. Как определяются "добрые условия"? Здесь "добрые условия" означают, во-первых, четкое описание процесса участия (что относится к более широкому управлению сообществом), а во-вторых, ясные требования к выполнению задачи.
  • Четко определенная технологическая стопка
    • "Новички" не обязательно имеют низкий уровень знаний, они просто еще не знакомы с этим проектом
    • Из объективной точки зрения, автор задачи может указать необходимые навыки для её решения
  • Ясное описание контекста
    • Даже опытные участники, не имеющие информации о контексте задачи, будут иметь трудности с её решением
    • Требования к навыкам для решения задачи
  • Отсутствие явных (или скрытых) временных ограничений
    • Мы не знаем, когда "новички" обратят внимание на эти задачи, поэтому не связываем такие задачи со своими мишенями (или другими планами выпусков)
  • Помощь в понимании структуры проекта (необязательно)
    • Важность выполнения задачи типа good-first-issue заключается не только в увеличении числа участников, но и в том, что она помогает новым участникам лучше узнать процесс внесения вклада и сам проект

Шаблон

Для того чтобы лучше понять концепцию good-first-issue, приведён ниже шаблон:

## Описание

## Технические требования

## Ожидаемый результат
```## Возможный список задач

Инструменты

Использование автоматизированных инструментов крайне важно для открытых проектов. Например, команда из Kubernetes представила Prow, который помогает поддерживать метки в проектах.

Другое

GitHub также предоставляет скрытую страницу (которую нельзя найти через кнопки или меню), доступ к которой можно получить при добавлении contribute к адресу репозитория какого-либо открытого проекта:

https://github.com/LinuxSuRen/open-source-best-practice/contribute

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/linuxsuren-open-source-best-practice.git
git@api.gitlife.ru:oschina-mirror/linuxsuren-open-source-best-practice.git
oschina-mirror
linuxsuren-open-source-best-practice
linuxsuren-open-source-best-practice
master