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

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

このコミットは、Goプロジェクトのコントリビューターリストに新しい貢献者であるAlexander Surma氏を追加するものです。具体的には、AUTHORSファイルとCONTRIBUTORSファイルにAlexander Surma氏の名前とメールアドレスが追記されています。

コミット

commit 09d3c95504a7ef42917b17c7b10adfce61b1e479
Author: Andrew Gerrand <adg@golang.org>
Date:   Mon Dec 17 09:11:26 2012 +1100

    A+C: Alexander Surma (individual CLA)
    
    Generated by addca.
    
    R=gobot
    CC=golang-dev
    https://golang.org/cl/6951043

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

https://github.com/golang/go/commit/09d3c95504a7ef42917b17c7b10adfce61b1e479

元コミット内容

このコミットの元々の内容は、Goプロジェクトへの貢献者であるAlexander Surma氏の個人コントリビューターライセンス契約（CLA）が承認されたことを示し、その結果としてAUTHORSファイルとCONTRIBUTORSファイルに彼の情報が追加されたことを記録しています。コミットメッセージには「Generated by addca.」とあり、addcaというツールによって自動生成されたものであることが示唆されています。また、レビュー担当者（R=gobot）とCCリスト（CC=golang-dev）も記載されています。https://golang.org/cl/6951043というChange List (CL) へのリンクも含まれていますが、このリンクは本コミットとは異なる、より新しいコミット（2024年7月23日付けのcmd/go: fix go mod tidy -compat=1.21 with go.workに関するもの）を指しており、このコミットが作成された2012年当時のCLとは一致しないようです。

変更の背景

Goプロジェクトのような大規模なオープンソースプロジェクトでは、知的財産権の管理が非常に重要です。貢献者がコードを提出する際に、プロジェクトがそのコードを合法的に使用、配布、変更できることを保証するために、コントリビューターライセンス契約（CLA）の締結を求めるのが一般的です。

このコミットの背景には、Alexander Surma氏がGoプロジェクトに貢献するにあたり、個人CLAを締結したという事実があります。CLAが締結されると、その貢献者の情報がプロジェクトの公式な貢献者リスト（AUTHORSおよびCONTRIBUTORSファイル）に追加されます。これにより、プロジェクトの透明性が保たれ、誰がプロジェクトに貢献しているかが明確になります。

コミットメッセージにある「Generated by addca.」という記述は、CLAの承認とそれに伴うファイル更新のプロセスが、addcaという内部ツールによって自動化されていることを示唆しています。これにより、手作業によるミスを防ぎ、効率的に貢献者情報を管理することができます。

前提知識の解説

コントリビューターライセンス契約 (Contributor License Agreement, CLA)

CLAは、個人または企業がオープンソースプロジェクトに貢献する際に、その貢献の著作権に関する権利をプロジェクトの所有者（この場合はGoogle）に付与するための法的な合意書です。CLAを締結することで、貢献者は自身のコードの著作権を保持しつつ、プロジェクト側は貢献されたコードをプロジェクトのライセンス（Goプロジェクトの場合はBSDライセンスなど）の下で自由に利用、配布、サブライセンスする権利を得ます。これにより、プロジェクトは将来的な著作権侵害の訴訟リスクを回避し、コードベースの健全性を保つことができます。

Goプロジェクトでは、Apache Software FoundationのCLAをベースにした独自のCLAを採用しており、個人用と企業用の2種類が存在します。貢献者はGoogle Developers Contributor License Agreementsのウェブサイトを通じてCLAに署名し、管理することができます。

AUTHORSファイルとCONTRIBUTORSファイル

多くのオープンソースプロジェクトでは、プロジェクトに貢献した人々の名前を記録するためのファイルが存在します。Goプロジェクトでは、主に以下の2つのファイルがその役割を担っています。

  • AUTHORS: このファイルは、プロジェクトの主要な作者や、特に重要な貢献をした人々をリストアップするために使用されることが多いです。歴史的な経緯やプロジェクトの初期からの貢献者が含まれる傾向があります。
  • CONTRIBUTORS: このファイルは、プロジェクトに何らかの形で貢献したすべての個人をリストアップするために使用されます。コードのコミットだけでなく、ドキュメントの改善、バグ報告、テストの作成など、幅広い貢献が含まれることがあります。

これらのファイルは、プロジェクトの透明性を高め、貢献者への感謝を示す役割を果たします。また、法的な観点からも、誰がどの部分に貢献したかを追跡するのに役立つ場合があります。

gobot

コミットメッセージのR=gobotは、この変更がgobotによってレビューされたことを示しています。gobotは、Goプロジェクトで利用されている自動化されたボットアカウントであると考えられます。このようなボットは、CLAの確認、コミットメッセージのフォーマットチェック、簡単なコードの静的解析など、定型的なレビュー作業を自動的に行うことで、人間のレビュー担当者の負担を軽減し、レビュープロセスを効率化する役割を担っています。

golang-devメーリングリスト

CC=golang-devは、このコミットがgolang-devというメーリングリストにCCされたことを意味します。golang-devは、Go言語の開発に関する議論が行われる主要なメーリングリストであり、Go言語のコア開発者や熱心な貢献者が購読しています。重要な変更やCLAの承認といったイベントは、このメーリングリストに通知されることで、関係者全員が情報を共有し、必要に応じて議論に参加できるようになります。

addcaツール

コミットメッセージに「Generated by addca.」とあることから、addcaはGoプロジェクト内部で使用されるツールであり、CLAの承認プロセスの一環として、AUTHORSおよびCONTRIBUTORSファイルに新しい貢献者の情報を自動的に追加する役割を担っていると推測されます。このような自動化ツールは、手作業によるエラーを減らし、一貫性を保ちながら、貢献者管理のワークフローを効率化するために不可欠です。公開されている情報からはaddcaツールの詳細な機能やソースコードは見つかりませんでしたが、その目的は明確です。

技術的詳細

このコミットの技術的詳細は、主にテキストファイルの変更に集約されます。Gitの差分情報を見ると、AUTHORSファイルとCONTRIBUTORSファイルの両方に、Alexander Surma氏の名前とメールアドレス（Alexander Surma <surma@surmair.de>）が1行ずつ追加されていることがわかります。

ファイルの変更は以下の通りです。

  • AUTHORS:
    • 変更前のインデックス: 0859525217
    • 変更後のインデックス: 0c69dabc8a
    • 変更行数: 1行追加
  • CONTRIBUTORS:
    • 変更前のインデックス: 4a1fc386d1
    • 変更後のインデックス: 6403cec9c1
    • 変更行数: 1行追加

これらのファイルは、通常、プレーンテキスト形式で管理されており、各行が1人の貢献者を表すシンプルな構造になっています。addcaツールは、CLAの承認が完了した際に、これらのファイルに適切な形式で新しいエントリを挿入するロジックを持っていると考えられます。挿入位置は、既存のリストのアルファベット順を維持するように設計されている可能性が高いです。

この種の変更は、Goプロジェクトのビルドシステムやテストには直接的な影響を与えません。これはコードの変更ではなく、プロジェクトのメタデータに関する変更だからです。しかし、プロジェクトの公式な記録として非常に重要であり、将来的に貢献者のリストを参照する際に利用されます。

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

このコミットにおける「コード」の変更箇所は、Go言語のソースコードそのものではなく、プロジェクトのメタデータファイルであるAUTHORSとCONTRIBUTORSの2つのテキストファイルです。

diff --git a/AUTHORS b/AUTHORS
index 0859525217..0c69dabc8a 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -16,6 +16,7 @@ Aleksandar Dezelin <dezelin@gmail.com>
 Alex Brainman <alex.brainman@gmail.com>
 Alexander Orlov <alexander.orlov@loxal.net>
 Alexander Reece <awreece@gmail.com>
+Alexander Surma <surma@surmair.de>
 Alexey Borzenkov <snaury@gmail.com>
 Amir Mohammad Saied <amir@gluegadget.com>
 Amrut Joshi <amrut.joshi@gmail.com>
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
index 4a1fc386d1..6403cec9c1 100644
--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -42,6 +42,7 @@ Aleksandar Dezelin <dezelin@gmail.com>
 Alex Brainman <alex.brainman@gmail.com>
 Alexander Orlov <alexander.orlov@loxal.net>
 Alexander Reece <awreece@gmail.com>
+Alexander Surma <surma@surmair.de>
 Alexandru Moșoi <brtzsnr@gmail.com>
 Alexey Borzenkov <snaury@gmail.com>
 Amir Mohammad Saied <amir@gluegadget.com>

コアとなるコードの解説

上記の差分が示すように、AUTHORSファイルとCONTRIBUTORSファイルの両方に、以下の行が追加されています。

+Alexander Surma <surma@surmair.de>

これは、Alexander Surma氏の名前と、彼がCLAを締結した際に登録したメールアドレスです。この行が追加されたことにより、Alexander Surma氏はGoプロジェクトの公式な貢献者リストに記載されることになります。

追加された位置は、既存のリストのアルファベット順に沿っていることがわかります。例えば、AUTHORSファイルではAlexander Reeceの後に、CONTRIBUTORSファイルではAlexander Reeceの後に挿入されています。これは、addcaツールがリストの順序を維持するように設計されていることを示唆しています。

これらのファイルは、Goプロジェクトのソースコードリポジトリの一部として管理されており、プロジェクトの歴史と貢献の記録として機能します。

関連リンク

参考にした情報源リンク