如何在GitHub上发出第一个拉取请求

如何创建PR以在GitHub上编辑项目?

有很多关于该主题的教程,但是它们通过假设必须做出贡献而使事情变得过于复杂。代码到一个项目。所以所有的吉特在此之前进行设置。

如果您只需要编辑文件,也许是项目README来解决打字错误,该怎么办?

您不需要知道如何编码或如何使用Git来做到这一点。但是,一旦开始执行“拉取请求”,您就可以做更多的事情,并可以与其他人协作进行项目!也许这将促使您以后也贡献代码。

我假设您已经有一个(免费)的GitHub帐户。如果不这样做,请转到github.com并得到一个。

让我告诉你这个过程。

我去了这个页面https://web.dev/prefers-color-scheme/我发现了一个可能的错字。这条线的末尾缺少一个点。

The article I want to edit

我不是语法纳粹,这只是为了寻找一个例子😄

我知道该网站托管在GitHub上,并且确切的文章托管在这里:https://github.com/GoogleChrome/web.dev/tree/master/src/site/content/en/blog/prefers-color-scheme

The github folder of the article

我打开index.md文件https://github.com/GoogleChrome/web.dev/blob/master/src/site/content/en/blog/prefers-color-scheme/index.md直接在GitHub上,然后按文件工具栏中的铅笔图标。悬停它时说:“分叉此项目并编辑文件”。

The index.md file

这将显示以下信息的编辑器视图:

您正在编辑一个没有写权限的项目中的文件。提交对此文件的更改会将其写入到分支flaviocopes / web.dev中的新分支中,因此您可以发送拉取请求。

The editor view

我可以添加该点,然后在底部的表单中说明所做的更改:

Propose file change

我按下“建议更改文件”按钮,然后显示一个比较视图。

Compare view

在这里,我可以查看所做的更改,以确保一切都很好,最后,我可以单击“创建请求请求”按钮。目前已对你的叉子的项目,这是由GitHub在单击铅笔图标时自动创建的。

Open pull request

在此视图的顶部,您可以看到我即将向PR提交PRGoogleChrome/web.dev我表单中的项目flaviocopes/web.dev,来自我的分行patch-2给他们master分支。

按下“创建请求请求”按钮会显示另一种形式,我可以在其中编写请求请求的详细说明。

拉取请求可以包含许多不同的更改,因此从理论上讲,您可以在同一PR中编辑许多文件,这就是为什么您可以添加摘要的原因。

该存储库具有用于PR文本的模板,以帮助团队对其进行管理。我们的PR非常简单,因此我删除了模板,仅粘贴了之前提交消息中的内容。

注意右边的提示吗?他们告诉我该项目有一个CONTRIBUTING.md文件,该文件说明了如何进行贡献和指导原则。挺酷的

Contributing

似乎我们需要签署CLA(贡献者许可协议)才能完成PR。过去,我已经签署了Google CLA,因此这一步骤对我来说很明显,但是您可能需要解决此问题。大多数项目并不真正需要它。

我单击“创建请求请求”,现在就发送PR!

Pull Request sent

现在由项目维护者介入并接受它,您只需要等待一封电子邮件,告诉您它已被合并,或者其他人有任何评论。

[…过去了几个小时…]

我收到了一封电子邮件,公关被拒绝了,因为那个点实际上在正确的位置! (我不知道)。

但是无论如何,这是我想补充的一点:如果您接受的PR不被接受,请不要生气或沮丧。该项目的维护者需要花费数月或数年的时间,并且他们比您更了解什么对它更好。

另外,尤其是对于代码,视图可能会非常不同,并且可能不欢迎您认为很棒的PR。

最好在进行实质性PR之前先询问,看看这是否是项目真正需要的东西。

但是,这本身就是一个话题。


更多git教程: