私はGitHubが初めてで、オープンソースの世界も初めてです(.NETから)。メディアWikiサイトがあり、Googleアナリティクス拡張機能をインストールしたい: http://www.mediawiki.org/wiki/Extension:Google_Analytics_Integration
拡張機能のドキュメントには、コードを GitHub からダウンロードするように記載されています。
GitHubリポジトリには、マスターと言う「レビュー」とブランチを言う「レビュー」があります。ブランチではなくマスターが必要だと思います。しかし、どのマスターをダウンロードするかをどうやって選ぶのですか?また、ドキュメントにはコミットの一部がタグ付けされると記載されていますが、そうではないようです。タグ/ドキュメントがなければ、どのコミットが安定していて、どのコミットが安定していないかを知る簡単な方法はありますか?
このようなプロジェクトのリポジトリにアプローチする方法についての一般的な知識が欲しいです。
リポジトリが通常のパターンに従っている場合(これは、私の経験では、他のVCSよりもGitリポジトリの方が少しありそうです)、安定したリリースにはmaster
ブランチが必要です。理論的には、それがmaster
にある場合、テストして機能させる必要があるため、master
への最新のコミットは最新の安定版リリースでなければなりません。
リンクしたリポジトリを見ると、「ブランチ」セクションに直行し、「マスター」を表示します。それをクリックすると、 this commit がタグ付けされていることがわかりますREL1_21
は、リリース1.21を意味すると想定しています。これは、ドキュメントで使用されているこのバージョンの名前に対応していると思います。始めるのに良い場所です。
そこからすばやくスキャンすると、ボットによるコミット、ローカリゼーションの更新がほとんど見られます。おそらくそこには何も侵入していません。変更について言及する one commit もあります。彼らが物事を適切に行っている場合、これは修正であり、間違いなくそれはmaster
へのコミットであるため、重大な変更ではありませんバージョンタグなし。このコミットに関するコメントを確認すると、下位互換性を維持するために取られた手順が記載されていることがわかります。
前回のリリース以降、master
に悪いことが何もないことに満足しているので、最新のコミットを取得します。執筆時点では this one です。このバージョンに問題がある場合、または変更が安全であると確信していなかった場合は、 最後にタグが付けられたコミット を取得し、バージョンがmaster
は、1.21以上のタグが付けられています(バージョン管理システムでの簡単な推測に基づいて、REL1_22
またはREL2_0
)。
もちろん、プロジェクトのドキュメントに正しいバージョンが示され、それを理解するこのプロセスが不要になることが望まれますが、悲しいことに常にそうとは限りません。この状況に気づいた場合、ここで使用したプロセスは、Gitなどのほとんどのリポジトリで機能します。ただし、漠然とした分別のある分岐戦略が使用されている必要があります。
Gitリポジトリでは、ほとんどの場合それを見つけるのは非常に簡単です。異なるブランチがあり、マスターはブランチの1つのブランチにすぎません。伝統的に、マスターには安定/承認済み/最新(ブランチの処理に依存)バージョンがあります。一部の人々はちょうどマスターで開発します。
そのようなリポジトリがGithubでホストされている場合(リンクされていない場合)、タグはかなり簡単に表示できます。リンクされたリポジトリは、最新のバージョンをmasterブランチに置いているようです。利用可能な最新のコミットを使用するだけです。
どのバージョンをダウンロードする必要があるかは、プロジェクトのメンテナンス方法に大きく依存します。 Githubリポジトリの例として、ここでは Symfony2 Githubリポジトリ を使用しています。