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

このコミットは、GoプロジェクトのAUTHORSファイルとCONTRIBUTORSファイルに、Sanjay Menakuru氏を追加するものです。これは、新しい貢献者がプロジェクトに加わった際に、その貢献を公式に記録するための標準的な手順です。

コミット

commit 12d4847263ffb016371f4b03f91be5f0caad1ad2
Author: Andrew Gerrand <adg@golang.org>
Date:   Tue Jan 3 14:10:12 2012 +1100

    A+C: add Sanjay Menakuru
    
    R=golang-dev, dsymonds
    CC=golang-dev
    https://golang.org/cl/5504110
---
 AUTHORS      | 1 +
 CONTRIBUTORS | 1 +
 2 files changed, 2 insertions(+)

diff --git a/AUTHORS b/AUTHORS
index 47ae2cf748..6b1707cc85 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -154,6 +154,7 @@ Roger Peppe <rogpeppe@gmail.com>
 Ron Minnich <rminnich@gmail.com>
 Ross Light <rlight2@gmail.com>
 Ryan Hitchman <hitchmanr@gmail.com>
+Sanjay Menakuru <balasanjay@gmail.com>
 Scott Lawrence <bytbox@gmail.com>
 Sebastien Binet	<seb.binet@gmail.com>
 Sébastien Paolacci <sebastien.paolacci@gmail.com>
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
index c7c6138852..81b86be8c6 100644
--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -232,6 +232,7 @@ Russ Cox <rsc@golang.org>
 Ryan Hitchman <hitchmanr@gmail.com>
 Sam Thorogood <thorogood@google.com> <sam.thorogood@gmail.com>
 Sameer Ajmani <ajmani@gmail.com>
+Sanjay Menakuru <balasanjay@gmail.com>
 Scott Lawrence <bytbox@gmail.com>
 Scott Schwartz <scotts@golang.org>
 Sebastien Binet	<seb.binet@gmail.com>

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

https://github.com/golang/go/commit/12d4847263ffb016371f4b03f91be5f0caad1ad2

元コミット内容

このコミットは、Goプロジェクトの公式な著者リストと貢献者リストに、Sanjay Menakuru氏を追加することを目的としています。コミットメッセージの "A+C: add Sanjay Menakuru" は、AUTHORSファイルとCONTRIBUTORSファイルの両方にSanjay Menakuru氏を追加したことを簡潔に示しています。

R=golang-dev, dsymondsとCC=golang-devは、この変更がGo開発チーム（golang-dev）とdsymonds氏によってレビューされたことを示しています。https://golang.org/cl/5504110は、この変更がGoプロジェクトのコードレビューシステム（Gerrit）における変更リスト（Change-ID）へのリンクです。

変更の背景

オープンソースプロジェクト、特に大規模なプロジェクトでは、プロジェクトに貢献した人々を公式に認識し、記録することが一般的です。これは、プロジェクトの透明性を高め、貢献者への感謝を示すとともに、知的財産権やライセンスに関する問題を明確にするためにも重要です。

AUTHORSファイルは通常、プロジェクトの主要な著者や初期の貢献者をリストアップするために使用されます。一方、CONTRIBUTORSファイルは、コード、ドキュメント、バグ報告、テストなど、様々な形でプロジェクトに貢献したすべての人々を網羅的にリストアップするために使用されます。

Sanjay Menakuru氏がGoプロジェクトに何らかの形で貢献したため、その貢献を公式に記録するために、これらのファイルに氏名とメールアドレスが追加されました。これは、オープンソースコミュニティにおける一般的な慣行であり、プロジェクトの健全な運営に不可欠な要素です。

前提知識の解説

Gitとコミット

Gitは、ソフトウェア開発で広く使用されている分散型バージョン管理システムです。コミットは、Gitにおける変更の最小単位であり、特定の時点でのプロジェクトの状態のスナップショットを記録します。各コミットには、変更内容、著者、コミット日時、コミットメッセージなどの情報が含まれます。

`AUTHORS`ファイルと`CONTRIBUTORS`ファイル

多くのオープンソースプロジェクトでは、プロジェクトに貢献した人々をリストアップするために、AUTHORSファイルとCONTRIBUTORSファイルを使用します。

AUTHORSファイル: プロジェクトの主要な開発者、創始者、または初期の重要な貢献者をリストアップすることが多いです。
CONTRIBUTORSファイル: プロジェクトに何らかの形で貢献したすべての人々（コードの寄稿者、バグ報告者、ドキュメント作成者、テスターなど）を網羅的にリストアップします。これは、プロジェクトのライセンスや著作権表示に関連する場合もあります。

これらのファイルは通常、プレーンテキスト形式で、各行に貢献者の名前とメールアドレスが記述されています。

`git diff`

git diffコマンドは、Gitリポジトリ内の2つの状態（コミット、ブランチ、作業ディレクトリなど）間の変更点（差分）を表示するために使用されます。このコミットの出力に含まれるdiffセクションは、このコミットによってファイルがどのように変更されたかを示しています。

--- a/AUTHORSと+++ b/AUTHORS: 変更前のファイル（a）と変更後のファイル（b）を示します。
@@ -154,6 +154,7 @@: これは「ハンクヘッダー」と呼ばれ、変更が行われたファイルの行番号情報を示します。この場合、AUTHORSファイルの154行目から6行が変更され、変更後には154行目から7行になったことを意味します（つまり1行追加された）。
行頭の+記号: 新しく追加された行を示します。

技術的詳細

このコミットは、GoプロジェクトのルートディレクトリにあるAUTHORSファイルとCONTRIBUTORSファイルという2つのテキストファイルを変更しています。これらのファイルは、特別なフォーマットを持つわけではなく、単に貢献者の名前とメールアドレスが1行ずつ記述されたリストです。

コミットの差分（diff）を見ると、両方のファイルで特定の行に新しいエントリが追加されていることがわかります。これは、既存のリストの途中に新しい名前が挿入されたことを示しています。これは、リストがアルファベット順にソートされている場合に一般的な操作です。

ファイルの変更は非常に単純で、既存のテキストファイルに新しい行を追加するだけです。Gitはこれらの変更を効率的に追跡し、差分として表示します。

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

diff --git a/AUTHORS b/AUTHors
index 47ae2cf748..6b1707cc85 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -154,6 +154,7 @@ Roger Peppe <rogpeppe@gmail.com>
 Ron Minnich <rminnich@gmail.com>
 Ross Light <rlight2@gmail.com>
 Ryan Hitchman <hitchmanr@gmail.com>
+Sanjay Menakuru <balasanjay@gmail.com>
 Scott Lawrence <bytbox@gmail.com>
 Sebastien Binet	<seb.binet@gmail.com>
 Sébastien Paolacci <sebastien.paolacci@gmail.com>
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
index c7c6138852..81b86be8c6 100644
--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -232,6 +232,7 @@ Russ Cox <rsc@golang.org>
 Ryan Hitchman <hitchmanr@gmail.com>
 Sam Thorogood <thorogood@google.com> <sam.thorogood@gmail.com>
 Sameer Ajmani <ajmani@gmail.com>
+Sanjay Menakuru <balasanjay@gmail.com>
 Scott Lawrence <bytbox@gmail.com>
 Scott Schwartz <scotts@golang.org>
 Sebastien Binet	<seb.binet@gmail.com>

コアとなるコードの解説

上記のgit diff出力は、AUTHORSファイルとCONTRIBUTORSファイルに対する変更を示しています。

AUTHORSファイルへの変更:
- +Sanjay Menakuru <balasanjay@gmail.com>という行が追加されています。これは、Ryan Hitchman <hitchmanr@gmail.com>の後に挿入されており、おそらくアルファベット順に並べられているためです。
CONTRIBUTORSファイルへの変更:
- 同様に、+Sanjay Menakuru <balasanjay@gmail.com>という行が追加されています。これもSameer Ajmani <ajmani@gmail.com>の後に挿入されており、アルファベット順を維持していると考えられます。

両方のファイルで、行頭の+記号は、その行が新しく追加されたことを意味します。このコミットは、既存のファイルに新しい情報を追記する、非常にシンプルかつ一般的なファイル操作です。

参考にした情報源リンク

Git公式ドキュメント: https://git-scm.com/doc
オープンソースプロジェクトにおけるAUTHORSおよびCONTRIBUTORSファイルの一般的な慣行に関する情報（一般的な知識に基づくため、特定のURLは提供しませんが、GitHubなどのオープンソースプラットフォームや、主要なオープンソースプロジェクトのドキュメントで確認できます）。
コミットメッセージ内のgolang.org/cl/5504110は、GoプロジェクトのGerritシステムにおける変更リストへのリンクです。

comemo