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

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

このコミットは、GoプロジェクトのAUTHORSファイルとCONTRIBUTORSファイルに、既存の貢献者であるStefan Nilsson氏のGmailアカウントを追加するものです。これにより、彼の連絡先情報が更新され、プロジェクトにおける彼の貢献がより正確に記録されます。

コミット

commit 885cbc3be4e37d8ac36265b2b8fdf0582cff0551
Author: Andrew Gerrand <adg@golang.org>
Date:   Thu Jan 19 14:44:21 2012 +1100

    A+C: add Stefan Nilsson's gmail account
    
    R=golang-dev, dsymonds
    CC=golang-dev
    https://golang.org/cl/5541064

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

https://github.com/golang/go/commit/885cbc3be4e37d8ac36265b2b8fdf0582cff0551

元コミット内容

A+C: add Stefan Nilsson's gmail account

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5541064

変更の背景

この変更の背景は、Goプロジェクトの貢献者リストであるAUTHORSファイルとCONTRIBUTORSファイルに、既存の貢献者であるStefan Nilsson氏の追加の連絡先情報(Gmailアカウント)を登録することです。オープンソースプロジェクトでは、貢献者の正確な情報を維持することが重要であり、これは連絡、クレジットの付与、法的な目的(例えば、DCO: Developer Certificate of Origin)のために役立ちます。

Goプロジェクトでは、AUTHORSファイルはプロジェクトの主要な作者をリストし、CONTRIBUTORSファイルはプロジェクトにコードやその他の形で貢献したすべての人々をリストします。これらのファイルは、プロジェクトの透明性と、貢献者への適切な認識を確保するために維持されています。

前提知識の解説

  • AUTHORSファイルとCONTRIBUTORSファイル: 多くのオープンソースプロジェクトでは、プロジェクトに貢献した人々の名前と連絡先情報を記録するために、これらのファイルが使用されます。AUTHORSは通常、プロジェクトの主要な開発者や創設者を指し、CONTRIBUTORSはより広範な貢献者(バグ修正、機能追加、ドキュメント作成など)を指します。これらのファイルは、プロジェクトの歴史と貢献者を追跡するための重要なドキュメントです。
  • Gitリポジトリ: Gitは分散型バージョン管理システムであり、プロジェクトのコードベースの変更履歴を追跡するために使用されます。コミットは、Gitにおける変更の最小単位であり、特定の時点でのコードベースのスナップショットと、その変更に関するメタデータ(作者、日付、コミットメッセージなど)を含みます。
  • コミットハッシュ: 各コミットには一意のSHA-1ハッシュが割り当てられます。これはコミットの識別子として機能し、特定のコミットを正確に参照するために使用されます。
  • コードレビュー (R=...): コミットメッセージ内のR=は、コードレビューを行ったレビュアーを示します。オープンソースプロジェクトでは、変更がコードベースにマージされる前に、他の開発者によるレビューを受けることが一般的です。これにより、コードの品質、正確性、およびプロジェクトのガイドラインへの準拠が保証されます。
  • CC (Carbon Copy): CC=は、コミットに関する通知を受け取るべき追加の個人またはメーリングリストを示します。これは、関連する関係者に変更を通知するために使用されます。
  • Change List (CL): https://golang.org/cl/5541064のようなリンクは、Goプロジェクトが内部的に使用しているGerritなどのコードレビューシステムにおける「Change List」へのリンクです。これは、コミットがマージされる前のレビュープロセスにおける変更のセットを表します。

技術的詳細

このコミットは、GoプロジェクトのルートディレクトリにあるAUTHORSファイルとCONTRIBUTORSファイルに対する単純なテキスト変更です。具体的には、Stefan Nilsson氏のエントリに新しいメールアドレス<trolleriprofessorn@gmail.com>が追加されています。

Gitの差分(diff)を見ると、以下の変更が行われたことがわかります。

  • AUTHORSファイル:
    • 変更前: Stefan Nilsson <snilsson@nada.kth.se>
    • 変更後: Stefan Nilsson <snilsson@nada.kth.se> <trolleriprofessorn@gmail.com>
  • CONTRIBUTORSファイル:
    • 変更前: Stefan Nilsson <snilsson@nada.kth.se>
    • 変更後: Stefan Nilsson <snilsson@nada.kth.se> <trolleriprofessorn@gmail.com>

この変更は、既存の行に新しいメールアドレスを追加する形で、2つのファイルでそれぞれ1行の変更(1挿入、1削除)として記録されています。これは、Gitが変更を「行の削除と新しい行の挿入」として扱うためです。

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

diff --git a/AUTHORS b/AUTHORS
index 205fb847d9..cd6d97abb6 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -163,7 +163,7 @@ Sergey 'SnakE'  Gromov <snake.scaly@gmail.com>
 Sergio Luis O. B. Correia <sergio@larces.uece.br>
 Shenghou Ma <minux.ma@gmail.com>
 Spring Mc <heresy.mc@gmail.com>
-Stefan Nilsson <snilsson@nada.kth.se>
+Stefan Nilsson <snilsson@nada.kth.se> <trolleriprofessorn@gmail.com>
 Stephen Weinberg <stephen@q5comm.com>
 Sven Almgren <sven@tras.se>
 Szabolcs Nagy <nsz@port70.net>
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
index 027e6b735c..669021d2fe 100644
--- a/CONTRIBUTORS
+++ b/CONTRIBUTORS
@@ -243,7 +243,7 @@ Sergey 'SnakE' Gromov <snake.scaly@gmail.com>
 Sergio Luis O. B. Correia <sergio@larces.uece.br>
 Shenghou Ma <minux.ma@gmail.com>
 Spring Mc <heresy.mc@gmail.com>
-Stefan Nilsson <snilsson@nada.kth.se>
+Stefan Nilsson <snilsson@nada.kth.se> <trolleriprofessorn@gmail.com>
 Stephen Ma <stephenm@golang.org>
 Stephen Weinberg <stephen@q5comm.com>
 Sugu Sougoumarane <ssougou@gmail.com>

コアとなるコードの解説

上記の差分が示すように、変更は非常にシンプルです。AUTHORSファイルとCONTRIBUTORSファイルの両方で、Stefan Nilssonという名前のエントリを探し、既存のメールアドレス<snilsson@nada.kth.se>の後に、新しいメールアドレス<trolleriprofessorn@gmail.com>が追加されています。

これは、Goプロジェクトの貢献者リストの正確性を維持するための定期的なメンテナンス作業の一部と考えられます。貢献者が新しい連絡先情報を持つようになった場合、それをプロジェクトの公式記録に反映させることは、コミュニケーションを円滑にし、将来的な参照のために重要です。

関連リンク

  • GoプロジェクトのGitHubリポジトリ: https://github.com/golang/go
  • Goプロジェクトの貢献ガイドライン(一般的なオープンソースプロジェクトの貢献方法について理解を深めるために役立つ可能性があります): https://go.dev/doc/contribute

参考にした情報源リンク

  • GoプロジェクトのGitHubコミットページ: https://github.com/golang/go/commit/885cbc3be4e37d8ac36265b2b8fdf0582cff0551
  • Gitの差分表示に関する一般的な情報(Gitのドキュメントなど)
  • オープンソースプロジェクトにおけるAUTHORSおよびCONTRIBUTORSファイルの役割に関する一般的な知識
  • Gerrit Code Review (Goプロジェクトが使用しているコードレビューシステム) に関する一般的な情報