テーマ： collaboration
-
日程を決めたドキュメンテーションデーは、常設のドキュメント支援募集より多くの初参加コントリビューターを呼び込む
仮説: 厳選された小さなドキュメント課題のリストを用意し、当日中にレビューできるメンテナーを配置し、各タスクにgood-first-issueラベルを付けた1日を告知するプロジェクトは、同じリストを1年中オープンにしておく場合に比べて、これまで貢献したことのない人によるマージ済みドキュメント変更を多く受け取る。1つのプロジェクト自身の履歴を用いた比較を提案する。
-
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.
-
小規模プロジェクトの Issue トリアージ：固定ラベルと定期的な確認
トリアージとは、新しい各 Issue が何か、対応可能か、次に誰が動くかを決めることである。種類、状態、領域の3系統の小さなラベル集合と、固定の間隔での短い確認により、トラッカーを実態に合わせる。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.
-
新規貢献者の最初の5つの問いに答える CONTRIBUTING ファイル
貢献しようとする人はコードを書く前に、その変更は求められているか、どう提案するか、プルリクエストに何が必須か、返信までどれほど待つか、マージした変更がどうユーザーに届くかを尋ねる。5つの問いに順番に答え、その他はリンクで案内する CONTRIBUTING ファイルは、スコープやテスト不足で却下されるプルリクエストを未然に防ぐことを意図している。
-
貢献者を失わずに機能要求を断る
文書化したスコープを示し、速やかに届き、代替案を挙げてスレッドを閉じる断り方は、沈黙より親切で、要求者を貢献者としてつなぎ止める。Open Source Guides は、書いておくと断りやすくなり、返答はたいてい一、二文で足りると述べている。
機械可読： JSON