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

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

このコミットは、Go言語の公式ドキュメント内のリンクを更新するものです。具体的には、以前の「Go Project Dashboard」へのリンクを、より新しい「Go Community Wiki」の「Projects」ページへのリンクに置き換えています。これにより、ユーザーは最新かつアクティブなGoプロジェクトのリストにアクセスできるようになります。

コミット

  • Author: Greg Ward greg@gerg.ca
  • Date: Mon Feb 11 09:18:31 2013 +1100

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

https://github.com/golang/go/commit/74e157764595054c13caf6b5bfdc324596ea2873

元コミット内容

doc: link to wiki Projects page instead of old Project Dashboard.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/7308079

変更の背景

この変更の背景には、Go言語のプロジェクトやコミュニティリソースの管理体制の移行があります。以前は「Go Project Dashboard」というプラットフォームがGo関連プロジェクトのリストを提供していましたが、このダッシュボードは時間の経過とともに更新が停止したり、より活発なコミュニティ主導のリソースに置き換えられたりすることがあります。

このコミットが行われた2013年2月時点では、Goコミュニティはプロジェクトの情報を「Go Community Wiki」に集約する方向へ移行していたと考えられます。そのため、公式ドキュメント内の古いリンクを更新し、ユーザーが最新かつ維持されている情報源に誘導されるようにすることが目的でした。これにより、ユーザーはGo言語のエコシステム内で利用可能なプロジェクトやライブラリをより効率的に発見できるようになります。

前提知識の解説

Go Project Dashboard (旧)

「Go Project Dashboard」は、かつてGo言語関連のプロジェクトを一覧表示するために使用されていたウェブアプリケーションです。これは主にGoogle App Engine上でホストされ、Go言語で書かれたプロジェクトやライブラリを開発者が登録し、他のユーザーが発見できるようにする目的がありました。しかし、このようなダッシュボードは、コミュニティの成長とともに維持が困難になったり、より柔軟なWiki形式のプラットフォームに役割を譲ったりすることがあります。

Go Community Wiki (Go Wiki)

「Go Community Wiki」（または単に「Go Wiki」）は、Go言語に関するコミュニティ主導のドキュメント、情報、リソースが集約されているWikiサイトです。これは通常、code.google.com/p/go-wikiのようなURLでホストされていました（Google Codeの閉鎖に伴い、現在はgolang.org/wikiなどに移行しています）。Wiki形式であるため、コミュニティメンバーが自由に情報を追加、編集、更新でき、プロジェクトのリスト、FAQ、チュートリアル、ベストプラクティスなど、多岐にわたる情報が提供されます。

このコミットの時点では、Go Project DashboardよりもGo Community Wikiの方が、Go関連プロジェクトの最新かつ包括的なリストを提供する場として機能していたため、ドキュメントのリンクが更新されました。

技術的詳細

このコミットは、Go言語の公式ドキュメントを構成するHTMLファイル内のハイパーリンク（<a>タグのhref属性）と表示テキストを修正しています。具体的には、以下の4つのファイルが変更されています。

  1. doc/articles/c_go_cgo.html
  2. doc/code.html
  3. doc/contrib.html
  4. doc/docs.html

これらのファイルは、Go言語のCgo（C言語との連携）に関する記事、コードの書き方に関するドキュメント、Goプロジェクトへの貢献方法、一般的なドキュメントの概要など、Go言語の様々な側面を説明するものです。

変更のパターンは一貫しており、http://godashboard.appspot.comまたはhttps://godashboard.appspot.comを指すリンクが、http://code.google.com/p/go-wiki/wiki/Projectsを指すリンクに置き換えられています。また、リンクの表示テキストも「Go Project Dashboard」から「Go Community Wiki」または「Go Wiki Projects Page」に変更されています。

これは、ウェブサイトのリンク切れを防ぎ、ユーザーを常に最新の情報源に誘導するための標準的なメンテナンス作業です。

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

diff --git a/doc/articles/c_go_cgo.html b/doc/articles/c_go_cgo.html
index 967f57e784..b37a6ba65b 100644
--- a/doc/articles/c_go_cgo.html
+++ b/doc/articles/c_go_cgo.html
@@ -169,9 +169,8 @@ in the Go tree demonstrate more advanced concepts.\n <p>\n For a simple, idiomatic example of a cgo-based package, see Russ Cox\'s <a\n href=\"http://code.google.com/p/gosqlite/source/browse/sqlite/sqlite.go\">gosqlite</a>.\n-Also, the Go Project Dashboard lists <a\n-href=\"https://godashboard.appspot.com/project?tag=cgo\">several other\n-cgo packages</a>.\n+Also, the <a href=\"http://code.google.com/p/go-wiki/wiki/Projects\">Go Community Wiki</a>\n+lists many packages, some of which use cgo.\n </p>\n \n <p>\ndiff --git a/doc/code.html b/doc/code.html
index 3ebb0bc9f9..82b211870d 100644
--- a/doc/code.html
+++ b/doc/code.html
@@ -480,8 +480,8 @@ import \"code.google.com/p/go.example/newmath\"\n <p>\n This convention is the easiest way to make your Go packages available for\n others to use.\n-The <a href=\"http://godashboard.appspot.com\">Go Project Dashboard</a>\n-is a list of external Go projects including programs and libraries.\n+The <a href=\"http://code.google.com/p/go-wiki/wiki/Projects\">Go Community Wiki</a>\n+has a list of external Go projects including programs and libraries.\n </p>\n \n <p>\ndiff --git a/doc/contrib.html b/doc/contrib.html
index ab4de34d74..a9f12f93f0 100644
--- a/doc/contrib.html
+++ b/doc/contrib.html
@@ -88,7 +88,7 @@ are particularly in need of outside help.\n <p>The <a href=\"http://groups.google.com/group/golang-nuts\">golang-nuts</a> \n mailing list is for general Go discussion.</p>\n \n-<h3 id=\"projects\"><a href=\"http://godashboard.appspot.com/project\">Go Project Dashboard</a></h3>\n+<h3 id=\"projects\"><a href=\"http://code.google.com/p/go-wiki/wiki/Projects\">Go Wiki Projects Page</a></h3>\n <p>A list of external Go projects including programs and libraries.</p>\n \n <h3 id=\"irc\"><a href=\"irc:irc.freenode.net/go-nuts\">Go IRC Channel</a></h3>\ndiff --git a/doc/docs.html b/doc/docs.html
index 256e1b915f..3112381c25 100644
--- a/doc/docs.html
+++ b/doc/docs.html
@@ -201,7 +201,7 @@ documentation.\n <p>The <a href=\"http://groups.google.com/group/golang-nuts\">golang-nuts</a>\n mailing list is for general Go discussion.</p>\n \n-<h3 id=\"projects\"><a href=\"http://godashboard.appspot.com/project\">Go Project Dashboard</a></h3>\n+<h3 id=\"projects\"><a href=\"http://code.google.com/p/go-wiki/wiki/Projects\">Go Wiki Projects Page</a></h3>\n <p>A list of external Go projects including programs and libraries.</p>\n \n <h3 id=\"irc\"><a href=\"irc:irc.freenode.net/go-nuts\">Go IRC Channel</a></h3>

コアとなるコードの解説

上記のdiff出力は、各ファイルで行われた具体的な変更を示しています。

  • doc/articles/c_go_cgo.html:

    • 削除行: <a href="https://godashboard.appspot.com/project?tag=cgo">several other cgo packages</a>
    • 追加行: <a href="http://code.google.com/p/go-wiki/wiki/Projects">Go Community Wiki</a>
    • 解説: Cgoに関する記事内で、Cgoパッケージのリストへのリンクが、古いダッシュボードからGo Wikiのプロジェクトページに更新されました。表示テキストも「several other cgo packages」から「Go Community Wiki」に変更され、より一般的な情報源への誘導となっています。

  • doc/code.html:

    • 削除行: <a href="http://godashboard.appspot.com">Go Project Dashboard</a>
    • 追加行: <a href="http://code.google.com/p/go-wiki/wiki/Projects">Go Community Wiki</a>
    • 解説: Goパッケージの利用可能性に関する説明の中で、外部Goプロジェクトのリストへのリンクが更新されました。表示テキストも「Go Project Dashboard」から「Go Community Wiki」に変更されています。

  • doc/contrib.html:

    • 削除行: <h3 id="projects"><a href="http://godashboard.appspot.com/project">Go Project Dashboard</a></h3>
    • 追加行: <h3 id="projects"><a href="http://code.google.com/p/go-wiki/wiki/Projects">Go Wiki Projects Page</a></h3>
    • 解説: 貢献に関するドキュメント内で、「Projects」セクションの見出しとリンクが更新されました。古いダッシュボードへのリンクがGo Wikiのプロジェクトページに置き換えられ、見出しも「Go Project Dashboard」から「Go Wiki Projects Page」に変更されています。

  • doc/docs.html:

    • 削除行: <h3 id="projects"><a href="http://godashboard.appspot.com/project">Go Project Dashboard</a></h3>
    • 追加行: <h3 id="projects"><a href="http://code.google.com/p/go-wiki/wiki/Projects">Go Wiki Projects Page</a></h3>
    • 解説: 一般的なドキュメントの概要内で、doc/contrib.htmlと同様に「Projects」セクションの見出しとリンクが更新されました。

これらの変更はすべて、Go言語のドキュメントが参照する外部リソースを、より適切で最新のコミュニティWikiに統一することを目的としています。

関連リンク

参考にした情報源リンク