Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

[インデックス 17439] ファイルの概要

このコミットは、Goプロジェクトの貢献者リストを更新するものです。具体的には、AUTHORSファイルに新しい貢献者であるTad Glinesを追加し、CONTRIBUTORSファイル内で既存の貢献者であるJP Sugarbroadのエントリを移動（実質的には削除と再追加）し、Tad Glinesのエントリを追加しています。これはコードベースの機能的な変更ではなく、プロジェクトの管理メタデータに関する更新です。

コミット

commit 048c577548d34e793d6ad950ff1d31a2cfa3adf0
Author: Brad Fitzpatrick <bradfitz@golang.org>
Date:   Thu Aug 29 17:19:51 2013 -0700

    A+C: Tad Glines (individual CLA)
    
    Generated by addca.
    
    R=gobot
    CC=golang-dev
    https://golang.org/cl/13416043

GitHub上でのコミットページへのリンク

https://github.com/golang/go/commit/048c577548d34e793d6ad950ff1d31a2cfa3adf0

元コミット内容

A+C: Tad Glines (individual CLA)

Generated by addca.

R=gobot
CC=golang-dev
https://golang.org/cl/13416043

変更の背景

オープンソースプロジェクト、特にGoのような大規模なプロジェクトでは、貢献者（コントリビューター）の管理は非常に重要です。これは、プロジェクトへの貢献を公式に認識し、知的財産権やライセンスに関する問題を適切に処理するためです。

このコミットの背景には、Tad Glines氏がGoプロジェクトに貢献するために、個人貢献者ライセンス契約（Individual Contributor License Agreement, CLA）を締結したことがあります。CLAは、貢献者が自身の貢献に対する著作権をプロジェクトの所有者（この場合はGoogle）に譲渡するか、または非独占的なライセンスを付与することを保証する法的な文書です。これにより、プロジェクトは貢献されたコードを安心して利用・配布できるようになります。

AUTHORSファイルとCONTRIBUTORSファイルは、プロジェクトに貢献した人々の名前を記録するためのものです。AUTHORSは通常、プロジェクトの主要な作者や初期の貢献者を指し、CONTRIBUTORSはそれ以外のすべての貢献者を網羅的にリストアップします。これらのファイルは、プロジェクトの透明性を高め、貢献者への感謝を示す役割も果たします。

コミットメッセージにある「Generated by addca.」は、この変更がaddcaというツールによって自動生成されたものであることを示唆しています。これは、CLAの締結や貢献者情報の追加といった管理プロセスを自動化するための内部ツールであると考えられます。また、「R=gobot」は、gobotという自動化されたシステム（ボット）がこの変更をレビューまたは承認したことを示しています。これは、Goプロジェクトにおけるコードレビューとマージのワークフローの一部です。

前提知識の解説

1. オープンソースプロジェクトにおける貢献者管理

オープンソースプロジェクトでは、世界中の開発者がコード、ドキュメント、バグ報告、テストなど様々な形で貢献します。これらの貢献を適切に管理することは、プロジェクトの健全な運営に不可欠です。

  • AUTHORSファイル: プロジェクトの主要な作者や、プロジェクトの初期段階から深く関わってきた人々をリストアップすることが多いです。
  • CONTRIBUTORSファイル: プロジェクトに何らかの形で貢献したすべての個人を網羅的にリストアップします。これには、コードのコミットだけでなく、バグ報告、ドキュメントの改善、テストの作成なども含まれる場合があります。

これらのファイルは、プロジェクトの歴史と貢献者の努力を記録する役割を果たします。

2. 貢献者ライセンス契約 (Contributor License Agreement, CLA)

CLAは、オープンソースプロジェクトにおいて、貢献者が自身のコードに対する著作権をプロジェクトの所有者（企業や財団など）に譲渡するか、または非独占的なライセンスを付与することを法的に保証するための契約です。

  • 目的:
    • 法的明確性: プロジェクトが貢献されたコードを自由に利用、変更、配布できることを保証し、将来的な著作権侵害の訴訟リスクを軽減します。
    • ライセンスの一貫性: プロジェクト全体のコードベースが単一のライセンスの下で配布されることを保証し、ライセンスの複雑化を防ぎます。
    • 再ライセンスの可能性: プロジェクトの所有者が将来的にプロジェクトのライセンスを変更する際に、貢献されたコードも新しいライセンスの下で再配布できることを可能にします。

Goプロジェクトの場合、Googleがプロジェクトの所有者であるため、貢献者はGoogleに対してCLAを締結します。

3. addcaツールとgobot

コミットメッセージに登場するaddcaとgobotは、Goプロジェクトの内部的なツールとシステムであると推測されます。

  • addca: "add contributor agreement" の略である可能性が高く、新しい貢献者がCLAを締結した際に、その情報をプロジェクトの貢献者リストファイル（AUTHORS, CONTRIBUTORS）に自動的に追加するためのツールであると考えられます。これにより、手動でのファイル編集ミスを防ぎ、プロセスを効率化します。
  • gobot: Goプロジェクトにおける自動化されたボットシステムです。コードレビューの初期段階でのチェック、CI/CDパイプラインのトリガー、あるいは今回のように特定の管理タスクの承認など、様々な自動化された役割を担っています。この文脈では、貢献者リストの更新という管理的な変更を自動的にレビューし、承認する役割を果たしたと考えられます。

これらのツールは、大規模なオープンソースプロジェクトが多数の貢献者を効率的かつ法的に安全に管理するために不可欠なインフラの一部です。

技術的詳細

このコミットは、Go言語のランタイムや標準ライブラリのコード自体には一切変更を加えていません。変更の対象は、プロジェクトのメタデータファイルであるAUTHORSとCONTRIBUTORSのみです。

具体的には、以下の変更が行われています。

  1. AUTHORSファイルへの追加: Tad Glines氏の名前とメールアドレスがAUTHORSファイルに新しい行として追加されました。これは、彼がGoプロジェクトの主要な貢献者の一員として認識されたことを意味します。
  2. CONTRIBUTORSファイルの変更:
    • JP Sugarbroad氏のエントリが元の位置から削除されました。
    • JP Sugarbroad氏のエントリが新しい位置に再追加されました。これは、単なるファイルの並び替えや、特定のセクションへの移動を示唆している可能性があります。
    • Tad Glines氏の名前とメールアドレスがCONTRIBUTORSファイルにも追加されました。これは、彼がGoプロジェクトへの貢献者として正式にリストアップされたことを意味します。

これらの変更は、テキストファイルへの単純な行の追加と移動であり、プログラミング言語の構文やセマンティクス、ランタイムの動作には影響を与えません。これは、プロジェクトの管理と法的なコンプライアンスを維持するための定期的なメンテナンス作業の一部です。

コアとなるコードの変更箇所

diff --git a/AUTHORS b/AUTHORS
index f6f409e493..d72bee01be 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -305,6 +305,7 @@ Steve McCoy <mccoyst@gmail.com>
 Steven Elliot Harris <seharris@gmail.com>
 Sven Almgren <sven@tras.se>
 Szabolcs Nagy <nsz@port70.net>
+Tad Glines <tad.glines@gmail.com>
 Taj Khattra <taj.khattra@gmail.com>
 Tarmigan Casebolt <tarmigan@gmail.com>
 Taru Karttunen <taruti@taruti.net>
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
index a3a8fc810c..a84164d1ba 100644
--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -214,7 +214,6 @@ Icarus Sparry <golang@icarus.freeuk.com>\n Ingo Oeser <nightlyone@googlemail.com> <nightlyone@gmail.com>\n Isaac Wagner <ibw@isaacwagner.me>\n Ivan Krasin <krasin@golang.org>\n-JP Sugarbroad <jpsugar@google.com>\n Jacob Baskin <jbaskin@google.com>\n James Aguilar <jaguilar@google.com>\n James David Chalfant <james.chalfant@gmail.com>\n@@ -272,6 +271,7 @@ Josh Bleecher Snyder <josharian@gmail.com>\n Josh Goebel <dreamer3@gmail.com>\n Josh Hoak <jhoak@google.com>\n Josh Holland <jrh@joshh.co.uk>\n+JP Sugarbroad <jpsugar@google.com>\n Jukka-Pekka Kekkonen <karatepekka@gmail.com>\n Julian Phillips <julian@quantumfyre.co.uk>\n Julien Schmidt <google@julienschmidt.com>\n@@ -432,6 +432,7 @@ Steven Elliot Harris <seharris@gmail.com>\n Sugu Sougoumarane <ssougou@gmail.com>\n Sven Almgren <sven@tras.se>\n Szabolcs Nagy <nsz@port70.net>\n+Tad Glines <tad.glines@gmail.com>\n Taj Khattra <taj.khattra@gmail.com>\n Tarmigan Casebolt <tarmigan@gmail.com>\n Taru Karttunen <taruti@taruti.net>\n```

## コアとなるコードの解説

上記のdiffは、`git diff`コマンドの出力形式で、変更されたファイルとその変更内容を示しています。

### `AUTHORS`ファイルへの変更

```diff
--- a/AUTHORS
+++ b/AUTHORS
@@ -305,6 +305,7 @@ Steve McCoy <mccoyst@gmail.com>
 Steven Elliot Harris <seharris@gmail.com>
 Sven Almgren <sven@tras.se>
 Szabolcs Nagy <nsz@port70.net>
+Tad Glines <tad.glines@gmail.com>
 Taj Khattra <taj.khattra@gmail.com>
 Tarmigan Casebolt <tarmigan@gmail.com>
 Taru Karttunen <taruti@taruti.net>
  • @@ -305,6 +305,7 @@: これは、変更がファイルの305行目から始まり、元のファイルでは6行が、変更後では7行が含まれることを示しています。
  • +Tad Glines <tad.glines@gmail.com>: この行は、AUTHORSファイルに「Tad Glines tad.glines@gmail.com」という新しいエントリが追加されたことを示しています。行頭の+は追加された行を意味します。

CONTRIBUTORSファイルへの変更

--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -214,7 +214,6 @@ Icarus Sparry <golang@icarus.freeuk.com>\n Ingo Oeser <nightlyone@googlemail.com> <nightlyone@gmail.com>\n Isaac Wagner <ibw@isaacwagner.me>\n Ivan Krasin <krasin@golang.org>\n-JP Sugarbroad <jpsugar@google.com>\n Jacob Baskin <jbaskin@google.com>\n James Aguilar <jaguilar@google.com>\n James David Chalfant <james.chalfant@gmail.com>\n@@ -272,6 +271,7 @@ Josh Bleecher Snyder <josharian@gmail.com>\n Josh Goebel <dreamer3@gmail.com>\n Josh Hoak <jhoak@google.com>\n Josh Holland <jrh@joshh.co.uk>\n+JP Sugarbroad <jpsugar@google.com>\n Jukka-Pekka Kekkonen <karatepekka@gmail.com>\n Julian Phillips <julian@quantumfyre.co.uk>\n Julien Schmidt <google@julienschmidt.com>\n@@ -432,6 +432,7 @@ Steven Elliot Harris <seharris@gmail.com>\n Sugu Sougoumarane <ssougou@gmail.com>\n Sven Almgren <sven@tras.se>\n Szabolcs Nagy <nsz@port70.net>\n+Tad Glines <tad.glines@gmail.com>\n Taj Khattra <taj.khattra@gmail.com>\n Tarmigan Casebolt <tarmigan@gmail.com>\n Taru Karttunen <taruti@taruti.net>\n```

*   `@@ -214,7 +214,6 @@`: 214行目から始まり、元のファイルでは7行が、変更後では6行が含まれることを示します。
*   `-JP Sugarbroad <jpsugar@google.com>`: この行は、`CONTRIBUTORS`ファイルから「JP Sugarbroad <jpsugar@google.com>」というエントリが削除されたことを示しています。行頭の`-`は削除された行を意味します。

*   `@@ -272,6 +271,7 @@`: 272行目から始まり、元のファイルでは6行が、変更後では7行が含まれることを示します。
*   `+JP Sugarbroad <jpsugar@google.com>`: この行は、`CONTRIBUTORS`ファイルに「JP Sugarbroad <jpsugar@google.com>」というエントリが再追加されたことを示しています。これは、ファイル内の別の場所への移動、またはリストの並び替えの結果であると考えられます。

*   `@@ -432,6 +432,7 @@`: 432行目から始まり、元のファイルでは6行が、変更後では7行が含まれることを示します。
*   `+Tad Glines <tad.glines@gmail.com>`: この行は、`CONTRIBUTORS`ファイルに「Tad Glines <tad.glines@gmail.com>」という新しいエントリが追加されたことを示しています。

これらの変更は、Goプロジェクトの貢献者リストの正確性と最新性を保つための、定期的な管理作業の一環です。

## 関連リンク

*   Goプロジェクトの貢献ガイドライン (一般的な情報): [https://go.dev/doc/contribute](https://go.dev/doc/contribute)
*   GoプロジェクトのCLAに関する情報 (GoogleのCLAページへのリンクがある場合があります): [https://cla.developers.google.com/](https://cla.developers.google.com/)

## 参考にした情報源リンク

*   Gitのdiff形式に関する一般的な情報: [https://git-scm.com/docs/git-diff](https://git-scm.com/docs/git-diff)
*   オープンソースプロジェクトにおけるCLAの役割に関する一般的な情報: [https://www.linuxfoundation.org/blog/contributor-license-agreements-cl-as-what-are-they-and-why-do-i-need-one/](https://www.linuxfoundation.org/blog/contributor-license-agreements-cl-as-what-are-they-and-why-do-i-need-one/)
*   GoプロジェクトのGitHubリポジトリ: [https://github.com/golang/go](https://github.com/golang/go)
*   GoプロジェクトのGerritコードレビューシステム (CLへのリンクから推測): [https://go.dev/cl/](https://go.dev/cl/) (具体的なCL番号は `13416043` ですが、直接リンクは提供されていませんでした)