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

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

このコミットは、GoプロジェクトのAUTHORSファイルとCONTRIBUTORSファイルに、Andrew Wilkins氏を個人貢献者として追加するものです。これは、Goプロジェクトへの貢献が認められた個人を公式に記録するための、一般的なオープンソースプロジェクトにおける慣行に沿った変更です。

コミット

commit fda29b6a4204d8658b3c1f763ac775afcc6cac00
Author: Robert Griesemer <gri@golang.org>
Date:   Thu Jul 26 11:47:29 2012 -0700

    A+C: added Andrew Wilkins (individual contributor)
    
    R=rsc, minux.ma, iant
    CC=golang-dev
    https://golang.org/cl/6447050

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

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

元コミット内容

このコミットの目的は、Andrew Wilkins氏をGoプロジェクトのAUTHORSファイルとCONTRIBUTORSファイルに個人貢献者として追加することです。コミットメッセージには、レビュー担当者(R=)とカーボンコピー(CC=)のリスト、および関連するGerritの変更リスト(CL)へのリンクが含まれています。

変更の背景

オープンソースプロジェクトにおいて、AUTHORSファイルやCONTRIBUTORSファイルは、プロジェクトに貢献した個人や組織を公式に認識し、記録するために使用されます。これは、貢献者への感謝を示すだけでなく、プロジェクトの歴史と所有権に関する透明性を提供するためにも重要です。Andrew Wilkins氏がGoプロジェクトに何らかの形で貢献したため、その貢献を正式に記録するためにこれらのファイルが更新されました。

前提知識の解説

AUTHORSファイルとCONTRIBUTORSファイル

オープンソースソフトウェアプロジェクトでは、プロジェクトの著作権情報と貢献者を管理するために、慣習的に特定のファイルが使用されます。

  • AUTHORSファイル: このファイルは通常、プロジェクトの主要な作者や著作権所有者をリストアップします。歴史的に、これはプロジェクトの初期開発者や、プロジェクトの大部分のコードベースに貢献した個人を指すことが多いです。著作権表示の目的で利用されることもあります。
  • CONTRIBUTORSファイル: このファイルは、プロジェクトに何らかの形で貢献したすべての個人をリストアップします。これには、コードの寄稿者だけでなく、ドキュメントの作成者、バグ報告者、テスター、翻訳者など、幅広い種類の貢献が含まれることがあります。AUTHORSファイルよりも広範な貢献者を対象とします。

これらのファイルは、プロジェクトのライセンスと組み合わせて、貢献者の権利とプロジェクトの利用条件を明確にする役割も果たします。特に、DCO (Developer Certificate of Origin) やCLA (Contributor License Agreement) を採用しているプロジェクトでは、貢献者がこれらのファイルに記載される前に特定の法的合意に同意していることが前提となる場合があります。GoプロジェクトもCLAを採用しています。

Gerrit (golang.org/cl)

https://golang.org/cl/6447050というリンクは、GoプロジェクトがコードレビューにGerritを使用していることを示しています。Gerritは、Gitリポジトリ上で動作するWebベースのコードレビューシステムです。開発者は変更をGerritにアップロードし、他の開発者がその変更をレビューし、承認することで、最終的にメインのコードベースにマージされます。CLは「Change List」の略で、Gerritにおける個々の変更セットを指します。

技術的詳細

このコミットは、Goプロジェクトのルートディレクトリにある2つのテキストファイル、AUTHORSCONTRIBUTORSに1行ずつ追加を行う非常にシンプルな変更です。

具体的には、以下の行が追加されています。

Andrew Wilkins <axwalk@gmail.com>

この行は、貢献者の氏名とメールアドレスを標準的な形式で記述したものです。

ファイルの変更は、既存のリストに新しいエントリを追加する形で行われており、ファイルの構造や既存のコンテンツに影響を与えるものではありません。単に新しい行が挿入されるだけです。

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

diff --git a/AUTHORS b/AUTHORS
index 5782614e84..a0a36dc946 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -23,6 +23,7 @@ Andrei Vieru <euvieru@gmail.com>
 Andrew Balholm <andybalholm@gmail.com>
 Andrew Pritchard <awpritchard@gmail.com>
 Andrew Skiba <skibaa@gmail.com>
+Andrew Wilkins <axwalk@gmail.com>
 Andrey Mirtchovski <mirtchovski@gmail.com>
 Andy Davis <andy@bigandian.com>
 Anh Hai Trinh <anh.hai.trinh@gmail.com>
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
index f5f3a0e121..4cd94a9902 100644
--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -51,6 +51,7 @@ Andrew Balholm <andybalholm@gmail.com>
 Andrew Gerrand <adg@golang.org>
 Andrew Pritchard <awpritchard@gmail.com>
 Andrew Skiba <skibaa@gmail.com>
+Andrew Wilkins <axwalk@gmail.com>
 Andrey Mirtchovski <mirtchovski@gmail.com>
 Andy Davis <andy@bigandian.com>
 Anh Hai Trinh <anh.hai.trinh@gmail.com>

コアとなるコードの解説

上記のdiffは、AUTHORSファイルとCONTRIBUTORSファイルの両方に、Andrew Wilkins <axwalk@gmail.com>という行が追加されたことを示しています。

  • --- a/AUTHORS+++ b/AUTHORS は、AUTHORSファイルの変更前と変更後を示します。
  • @@ -23,6 +23,7 @@ は、変更がファイルの23行目から始まり、変更前は6行、変更後は7行になることを示します。これは、1行が追加されたことを意味します。
  • +Andrew Wilkins <axwalk@gmail.com> の行頭の+は、この行が新しく追加されたことを示します。

同様に、CONTRIBUTORSファイルでも同じ行が追加されています。これらの変更は、Andrew Wilkins氏がGoプロジェクトの公式な貢献者リストに登録されたことを意味します。

関連リンク

参考にした情報源リンク

  • Git diffの読み方に関する一般的な情報
  • オープンソースプロジェクトにおけるAUTHORSおよびCONTRIBUTORSファイルの役割に関する一般的な情報
  • Gerritに関する一般的な情報
  • Goプロジェクトの公式ドキュメント (特に貢献に関するセクション)