使用 GitHub 作为教程项目的代码存储库答案

【问题标题】：Using GitHub as a code repository for tutorial project使用 GitHub 作为教程项目的代码存储库
【发布时间】：2012-11-27 02:03:00
【问题描述】：

我正在计划一个项目，并且想知道使用 GitHub 作为项目的代码存储库是否是个好主意。

该项目只是我一步一步创建一个应用程序。事实上，这更像是我学习如何去做，记录我的过程，并让其他人跟着做。

所以第 1 步可能是设置项目，第 2 步如何组织文件，第 2 步连接到数据库，第 3 步如何做 UI 等（顺便说一句。这不是项目的设置方式）

文档将包含一个网站，其中包含每个步骤的文章，以及每个步骤，我希望访问者能够下载/查看项目的代码，直到我们处于流程中。

我不知道如何使用 GitHub，但我也打算学习它。 GitHub 是共享此类项目代码的好方法吗？

GitHub 中有没有办法拍摄快照，例如第 1 步、第 2 步等，或者为此使用分支或分叉会更好？

如果我在第一步中发现拼写错误，可以更正整个步骤链。

有人知道以类似方式设置的现有 GitHub 项目吗？

【问题讨论】：

标签： github

【解决方案1】：

您可以使用 GitHub，前提是您还为每个重要步骤推送标签。
（如“How do I use github tags to create downloads for my project?”中所述）

这样，您可以为每个标签提供下载链接，即使对于没有安装 Git 的读者也是如此。

【讨论】：

标签的使用能否让我稍后在项目的第 1 步中进行编辑并将编辑级联到其他步骤？
@user1182478 不，那将是分支，将从您的标签开始，足够方便。使用 GitHub，您也可以也下载分支 HEAD，而无需在本地安装 Git (stackoverflow.com/questions/6978954/…)。
@user1182478 正如我在stackoverflow.com/questions/13753703/… 中解释的那样，标签是不可变的并且引用历史中的一个固定点（这可能是每一步进化的起点）。分支用于可变历史。
@user1182478 一旦你管理了这些分支，修复 stepn 中的错误将涉及重新设置所有其他后续分支：stepn+1 在 stepn 之上，stepn+2 在（因为 rebase 是新的）stepn 之上+1 等。我更喜欢经典的樱桃采摘（在technosophos.com/content/… 中说明）