Тема: collaboration
-
Запланированный день документации привлекает больше новых контрибьюторов, чем постоянно висящий призыв помочь с документацией
Гипотеза: проект, который назначает один день с отобранным списком небольших задач по документации, доступными в этот день для ревью мейнтейнерами и меткой good-first-issue на каждой задаче, получает больше принятых изменений документации от людей, которые раньше никогда не контрибьютили, чем тот же список задач, весь год провисевший открытым; предлагается сравнение на истории одного и того же проекта.
-
Describing a change so that reviewers can review it
A change description states the problem, the approach and its alternatives, how it was tested and what reviewers should look at; it links the ticket and lists risks and follow-ups, so review starts with understanding instead of archaeology.
-
Prefer change proposals for external ownership
Improve another contributor’s material through a revision-bound proposal when direct replacement is not authorized.
-
Разбор задач небольшого проекта: фиксированные метки и регулярный обход
Разбор означает определить для каждой новой задачи, что это, можно ли по ней действовать и кто делает следующий шаг. Небольшой словарь меток трёх семейств (тип, статус, область) и короткий регулярный обход поддерживают достоверность трекера. Стандартные метки GitHub, среди которых bug, enhancement, documentation, duplicate, question, wontfix, good first issue и help wanted, подходят как начальный набор.
-
Recognising contributors: a contributors table by contribution type, without rankings
The All Contributors specification calls for a Contributors section in a prominent place, as a table of name, link and contribution category, inclusive of every kind of contribution at any level, with order immaterial; it recommends against excluding anyone for a perceived low level of contribution. Git's Co-authored-by trailer credits co-authors of a single commit. Together they let a small project credit documentation, triage, design and reports, not only merged code.
-
Файл CONTRIBUTING, отвечающий на первые пять вопросов новичка
Прежде чем писать код, потенциальный участник спрашивает: нужно ли это изменение, как его предложить, что обязан содержать запрос на включение изменений, когда ждать ответа и как принятое изменение попадёт к пользователям. Файл CONTRIBUTING, последовательно отвечающий на эти пять вопросов и дающий ссылки по остальным, призван предотвратить запросы, которые отклонят из-за выхода за рамки проекта или отсутствия тестов.
-
Как отклонить запрос функции и сохранить участника проекта
Отказ, который ссылается на письменные границы проекта, приходит быстро, называет альтернативу и закрывает обсуждение, добрее молчания и сохраняет запросившего как участника. Open Source Guides отмечают, что письменная фиксация облегчает отказ, а ответу редко требуется больше одного-двух предложений.
Машиночитаемо: JSON