如何查看GitHub存储库并知道要下载哪个版本的代码？

Question

我是GitHub新手，也是开源世界的新手(来自.NET)。我有一个媒体wiki站点，希望安装Google分析扩展：http://www.mediawiki.org/wiki/Extension:Google_分析_集成。

扩展的文档说要从GitHub下载代码。

在GitHub回购中，有一些“评论”说的是主人，有些说的是分支。我想我想要的是主人而不是树枝。但是我如何选择下载哪一位大师呢？此外，文档还说，某些提交将被标记，但情况似乎并非如此。没有标记/文档，有什么简单的方法可以知道哪些提交是稳定的，哪些提交不是稳定的？

我喜欢一些关于如何在这样的项目中进行回购的一般智慧。

Answer 1

如果存储库遵循的是通常的模式(在我的经验中，Git repos比其他VCS更有可能)，那么您需要master分支来实现稳定的版本。从理论上讲，如果它是在master中，那么它应该被测试和工作，所以最近对master的承诺应该是最新的稳定版本。

看着你链接的回购，我直接走到“分支”部分，看看“主人”。点击这个按钮，我看到此承诺被标记为REL1_21，我认为它意味着1.21版本，我猜它对应于他们文档中使用的这个版本的名称。这是个很好的开始。

快速扫描从那里，我看到大多数提交由一个机器人，更新本地化。可能没什么破绽。还有一个一次承诺提到了一个变化。如果他们做的很好，这应该是一个修复，而不是一个突破性的改变，因为这是一个提交到master没有版本标记。在检查对此提交的评论时，我发现它提到了为保持向后兼容性而采取的步骤。

现在我很高兴自上一次发布以来没有什么坏消息被推到master上，我只需获取最新的提交:在编写本报告时，这是这一个。如果我对这个版本有问题，或者我不相信更改是安全的，我会得到最后标记提交，并坚持使用它，直到他们向master添加一个带有高于1.21的标记的版本(根据对他们的版本控制系统的快速猜测，该版本将是REL1_22或REL2_0)。

当然，人们会希望项目的文档能够为您指出正确的版本，从而使您不必自己解决这个问题，但遗憾的是，情况并不总是这样。当您发现自己处于这种情况时，我在这里使用的过程对于大多数存储库( Git或其他存储库)都有效，前提是使用了一种模糊合理的分支策略：

• 找到一个叫做“主”、“主人”、“稳定”或类似的分支。
• 找到最后一个版本标记的提交到那个分支。
• 检查该分支中没有添加任何奇怪的内容--任何可能导致破坏的更改( )。
  • 如果什么都没有，抓住最新的提交
  • 如果存在潜在的问题更改，则获取标记的提交。

• 无论哪种方式，如果您的版本有问题，请移回以前标记的提交。
• 当您找到一个有效的版本，坚持它直到他们发布一个新的标记版本，然后得到它。如果不起作用，请回到以前的版本，等待新版本的出现。

Answer 2

在git存储库中，很容易找到它。将有不同的分支和主人只是一个分支的分支。在传统上，您将在主版上找到稳定/批准/当前(取决于分支处理)版本。有些人是和师父一起培养的。

如果这样的存储库托管在Github上(链接不是)，那么您可以很容易地看到这些标记。链接存储库似乎将最新版本放在主分支上。您只需使用最新可用的提交即可。

您应该下载的版本在很大程度上取决于项目的维护方式。作为Github存储库的一个例子，这里是Symfony2 Github存储库。