想要做出你的第一个开源贡献吗?无论贡献多小,所有贡献都是一个很大的帮助。该博客旨在帮助那些刚开始接触开源社区的人提交他们的第一个拉取请求,无论是针对 Hacktoberfest 还是针对任何开源项目。
我假设您已经在您的计算机上安装了git并且已经在您的 GitHub 帐户上设置了您的ssh 密钥。
你建议立即进行删除厨余垃圾有哪些的第一件事ð要做的就是在你回购叉它之前,如果有行为的文件或文件contributing.md的代码,然后去克服它,它就会在维护者如何想你做你的贡献,从如何提出问题,命名你的分支/拉取请求和文档。这很重要,因为它将使维护者和批准者的工作更容易。
如果您有任何问题或需要帮助,您可以在此处在 Twitter 上问我,也可以在 GitHub 上关注我以查看我在此处执行的拉取请求示例
目录
- 分叉回购
- 使用git clone 克隆Fork
- 使用git checkout 创建一个新分支
- 使用git config配置您的姓名和电子邮件
- 添加您的姓名作为贡献者
- 使用git status检查您的更改
- 使用git add添加更改
- 使用git commit提交更改
- 使用git push推送您的更改
- 创建您的拉取请求!
分叉回购
导航到您想要贡献的存储库,然后单击 fork 按钮。这会将存储库的副本分叉到您的 GitHub 名称。
git 克隆
现在你已经分叉了这个 repo,你现在可以从你的帐户中克隆它,然后 cd 到文件夹中开始处理它。
git clone git@github.com :bradmccoydev/how-to-dok.git
cd how-to-dok
结帐
我们现在需要创建一个新分支,为此,我们可以使用git checkout命令。对于命名约定,最好通读 repo 以了解它们是如何做的,通常您可以在CONTRIBUTING.md文件中找到它,或者您可以查看 GitHub 中的其他拉取请求,以了解人们如何命名分支等.
git checkout -b 30/add-bradmccoydev-to-contributors
混帐配置
您需要做的第一件事是配置您要在提交中显示的姓名和电子邮件,这将显示在您提交的存储库历史记录中。
git config --global user.name "<name>"
git config --global user.email "<email>"
添加您的姓名作为贡献者
贡献者要么直接在自述文件中,要么在 CONTRIBUTORS.md 文件中。打开您最喜欢的编辑器并添加您的名字!
* [布拉德·麦考伊]( https://github.com/bradmccoydev )
状态
此命令用于检查已更改代码的状态,在提交更改之前添加更改之前使用此命令很有用。
状态
git 添加。
现在我们已经进行了添加它们所需的更改。我们可以使用git add 。添加所有更改。有很多方法可以添加文件,但这是最简单的。
git 添加。
提交
现在我们已经添加了我们想要提交的文件,我们现在可以提交它们,大多数开源项目都希望您签署不经常记录的提交,您只需添加 -s 参数即可完成此操作。您现在可以再次使用git status命令来检查
git commit -m "将布拉德麦考伊添加到 CONTRIBUTORS.md" -s
推
我们现在已准备好将此更改推送到您的远程 git 存储库。我们可以使用 git push origin 来推送它。这通常会在最后为您提供一个链接以创建拉取请求。如果你没有得到它,你可以去原来的 repo 并创建一个。
git push origin 30/add-bradmccoydev-to-contributors
创建您的拉取请求
最后一步是创建拉取请求。如果有与之相关的问题,您可以评论“This closes issue 30”,这对维护者很有帮助。
恭喜!
您现在已经提交了第一个拉取请求。拉取请求被批准并合并后,您将能够在主分支中看到您的代码!