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

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

このコミットは、GoプロジェクトのAUTHORSファイルとCONTRIBUTORSファイルに新しい貢献者であるSteven Hartland氏を追加するものです。これは、オープンソースプロジェクトにおける貢献者の記録と認識のプロセスの一部です。

コミット

commit f9a408c1d97c8180aa2488ea9e3c47a319c3ddba
Author: Brad Fitzpatrick <bradfitz@golang.org>
Date:   Mon Mar 10 09:34:57 2014 -0700

    A+C: Steven Hartland (individual CLA)
    
    Generated by addca.
    
    R=gobot
    CC=golang-codereviews
    https://golang.org/cl/73630043
---
 AUTHORS      | 1 +
 CONTRIBUTORS | 1 +
 2 files changed, 2 insertions(+)

diff --git a/AUTHORS b/AUTHORS
index 82d038422d..fc6fed45b5 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -366,6 +366,7 @@ Stephen McQuay <stephen@mcquay.me>
 Stephen Weinberg <stephen@q5comm.com>
 Steve McCoy <mccoyst@gmail.com>
 Steven Elliot Harris <seharris@gmail.com>
+Steven Hartland <steven.hartland@multiplay.co.uk>
 Sven Almgren <sven@tras.se>
 Szabolcs Nagy <nsz@port70.net>
 Tad Glines <tad.glines@gmail.com>
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
index a5e3d543bb..e3fbe7defd 100644
--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -504,6 +504,7 @@ Stephen McQuay <stephen@mcquay.me>
 Stephen Weinberg <stephen@q5comm.com>
 Steve McCoy <mccoyst@gmail.com>
 Steven Elliot Harris <seharris@gmail.com>
+Steven Hartland <steven.hartland@multiplay.co.uk>\n Sugu Sougoumarane <ssougou@gmail.com>\n Sven Almgren <sven@tras.se>\n Szabolcs Nagy <nsz@port70.net>\n"}}

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

https://github.com/golang/go/commit/f9a408c1d97c8180aa2488ea9e3c47a319c3ddba

元コミット内容

A+C: Steven Hartland (individual CLA)

Generated by addca.

R=gobot
CC=golang-codereviews
https://golang.org/cl/73630043

変更の背景

このコミットの背景は、Steven Hartland氏がGoプロジェクトに貢献し、その貢献が認められたことにあります。オープンソースプロジェクトでは、コードの変更をコミットする前に、貢献者がプロジェクトのライセンスと貢献ポリシーに同意することを示すために、Contributor License Agreement (CLA) に署名することが一般的です。このコミットメッセージにある「individual CLA」は、Steven Hartland氏が個人の資格でCLAに署名したことを示しています。

AUTHORSファイルとCONTRIBUTORSファイルは、プロジェクトに貢献した人々を公式に記録するためのものです。これにより、プロジェクトの歴史と、誰がどのような形でプロジェクトに関わったかを追跡することができます。

前提知識の解説

  • Contributor License Agreement (CLA): 貢献者ライセンス同意書。オープンソースプロジェクトにおいて、外部の貢献者がコードを提出する際に、そのコードの著作権やライセンスに関する権利をプロジェクトに付与することに同意するための法的な文書です。これにより、プロジェクトは貢献されたコードを安心して利用・配布できるようになります。Goプロジェクトでは、Googleが管理するCLAが使用されています。
  • AUTHORSファイル: プロジェクトの主要な作者や貢献者をリストアップするファイルです。通常、プロジェクトの初期からの主要な開発者や、多大な貢献をした人々が記載されます。
  • CONTRIBUTORSファイル: プロジェクトに貢献したすべての個人をリストアップするファイルです。コードのコミットだけでなく、ドキュメントの改善、バグ報告、テストの作成など、様々な形の貢献をした人々が含まれることがあります。
  • addca: このコミットメッセージにある「Generated by addca」は、この変更がaddcaというツールによって生成されたことを示唆しています。これは、CLAに署名した貢献者をAUTHORSやCONTRIBUTORSファイルに自動的に追加するための内部ツールであると考えられます。
  • R=gobot: レビュー担当者（Reviewer）がgobotであることを示します。gobotはGoプロジェクトの自動化されたシステムの一部であり、特定の種類のコミット（例えば、CLAの追加など）を自動的に承認する役割を果たすことがあります。
  • CC=golang-codereviews: この変更がgolang-codereviewsメーリングリストに通知されることを示します。これは、Goプロジェクトのコードレビュープロセスの一部です。
  • https://golang.org/cl/73630043: このコミットに対応するGerrit Code Reviewのチェンジリストへのリンクです。GoプロジェクトはGerritを使用してコードレビューを行っています。

技術的詳細

このコミットは、Goプロジェクトのソースコード管理におけるメタデータ管理の一例です。AUTHORSおよびCONTRIBUTORSファイルは、プロジェクトの歴史と貢献者を追跡するための重要なドキュメントです。これらのファイルは、通常、手動で編集されるのではなく、CLAの署名やその他の貢献プロセスと連携して自動的に更新されることが多いです。

このコミットでは、diffコマンドの出力からわかるように、AUTHORSファイルとCONTRIBUTORSファイルの両方に、Steven Hartland氏の名前とメールアドレスが追加されています。

  • AUTHORSファイルへの追加:

    --- a/AUTHORS
+++ b/AUTHORS
@@ -366,6 +366,7 @@ Stephen McQuay <stephen@mcquay.me>
 Stephen Weinberg <stephen@q5comm.com>
 Steve McCoy <mccoyst@gmail.com>
 Steven Elliot Harris <seharris@gmail.com>
+Steven Hartland <steven.hartland@multiplay.co.uk>
 Sven Almgren <sven@tras.se>
 Szabolcs Nagy <nsz@port70.net>
 Tad Glines <tad.glines@gmail.com>

    この差分は、AUTHORSファイルの366行目付近にSteven Hartland <steven.hartland@multiplay.co.uk>という行が追加されたことを示しています。

  • CONTRIBUTORSファイルへの追加:

    --- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -504,6 +504,7 @@ Stephen McQuay <stephen@mcquay.me>
 Stephen Weinberg <stephen@q5comm.com>
 Steve McCoy <mccoyst@gmail.com>
 Steven Elliot Harris <seharris@gmail.com>
+Steven Hartland <steven.hartland@multiplay.co.uk>
 Sugu Sougoumarane <ssougou@gmail.com>
 Sven Almgren <sven@tras.se>
 Szabolcs Nagy <nsz@port70.net>

    同様に、CONTRIBUTORSファイルの504行目付近にも同じ情報が追加されています。

これらのファイルは、プロジェクトの透明性を高め、貢献者への適切なクレジットを保証するために重要です。また、法的な観点からも、誰がプロジェクトに貢献したかを明確にすることは、ライセンス遵守の観点から役立ちます。

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

このコミットにおけるコアとなるコードの変更箇所は、以下の2つのファイルへの追加行です。

  1. AUTHORSファイル
  2. CONTRIBUTORSファイル

具体的には、両ファイルに以下の1行が追加されています。

Steven Hartland <steven.hartland@multiplay.co.uk>

コアとなるコードの解説

このコミットは、Goプロジェクトのコードベース自体に機能的な変更を加えるものではありません。代わりに、プロジェクトのメタデータ、特に貢献者に関する情報を更新しています。

  • AUTHORSファイル: このファイルは、Goプロジェクトの主要な作者を列挙しています。Steven Hartland氏がこのファイルに追加されたということは、彼がGoプロジェクトに対して重要な貢献を行ったと認識されたことを意味します。
  • CONTRIBUTORSファイル: このファイルは、Goプロジェクトに貢献したすべての個人を列挙しています。このファイルに追加されることは、Goプロジェクトへの貢献が公式に記録されたことを意味します。

これらのファイルは、プロジェクトの健全なコミュニティを維持し、貢献者への感謝を示す上で重要な役割を果たします。また、将来的にプロジェクトのライセンスや著作権に関する問題が発生した場合に、貢献者を特定するための記録としても機能します。

関連リンク

参考にした情報源リンク

  • GoプロジェクトのGitHubリポジトリ (コミット履歴とファイル内容の確認)
  • 一般的なオープンソースプロジェクトにおけるCLA、AUTHORS、CONTRIBUTORSファイルの役割に関する知識
  • Gerrit Code Reviewの一般的なワークフローに関する知識
  • コミットメッセージ内のキーワード (addca, gobot, golang-codereviews) から推測されるGoプロジェクトの内部プロセスに関する知識
  • https://golang.org/cl/73630043 (Gerritチェンジリストへの直接リンク)