【学习分享】记录开源小白的第一次 PR

RT-Thread物联网操作系统 2022-06-14 09:18:21

加精

本文由RT-Thread论坛用户@yanlineng原创发布：https://club.rt-thread.org/ask/article/5a3155877b44066c.html

大家好，我是一枚开源小白。之前没有过开源经历，没有实际体验过开源过程，也没有参加过开源活动。凭借好奇和学习的心态，想在开源社区提交自己的贡献；最近自己第一次向RT-Thread官方仓库提交PR，最终成功合并，算是一次开源的入门，也是自己第一段开源经历。这里想简单记录一下这一次PR的过程，希望能够帮到想要参与开源以及即将要参与开源的小伙伴~

关于工具与准备

需要“科学上网”工具，便于访问 Github；
在PC上安装 git 环境；
了解一下 git 相关基本概念，基本命令，了解一下这个强大的版本控制软件；
参考：Git 基础与分支 | Github的基本操作

可以为开源项目贡献什么？怎样快速参与到开源？

这想必是和我一样的开源小白会遇到的第一个问题。我想参与进来，但是我能做些什么贡献什么？其实我们可以多看看官方仓库的 issue ，这里面有一些大家提出的问题或者正在需要解决的问题，涉及到方方面面：

这里面有很多问题和话题，如果自己没有目标的话可以先逛一逛，看一看哪些问题自己感兴趣或者能解决。这样初步的一个目标就可以定下来了。而对于小白来说，可以先看看 “good first issue” 标签分类下的 issue，随便点一下上面蓝色的标签就可以看到全部该标签下的 issue（这一类的 issue 更适合刚入门的开源小白）。或者有自己的想法也可以，觉得哪里不好想自己动手完善一下。选好目标，就可以开始做啦。

我这次主要是做的 bsp 中文档完善相关的贡献，首先体验一下整个 PR 过程。

如何修改内容？

首先要将官方仓库 fork 到我们自己的仓库下，点击一下 Fork 按钮，按照提示操作就可以 Fork 完成了。

然后在自己的仓库里就可以看到刚刚 fork 过来的 rt-thread ：

接着点击 Code 按钮，使用 SSH 方式克隆到本地，首先复制一下 ssh 的链接。

我是一枚开源小白。之前没有过开源经历，没有实际体验过开源过程，也没有参加过开源活动。凭借好奇和学习的心态，想在开源社区提交自己的贡献；最近自己第一次向RT-Thread官方仓库提交PR，最终成功合并，算是一次开源的入门，也是自己第一段开源经历。这里想简单记录一下这一次PR的过程，希望能够帮到想要参与开源以及即将要参与开源的小伙伴~

在本地PC上，选择一个合适的目录，点击右键打开 Git Bash Here ，进入 git 命令行工具后使用 git clone 命令克隆仓库到本地：

git clone [刚刚复制的ssh链接]

ps：这里建议配置一下 github 的 ssh 连接方式（参考），以后每次拉取或推送修改到自己的仓库时就不需要输入密码了。去年 github 更新过关于 ssh 的使用，ssh 密钥的生成方式最好按照官方教程去生成 ed25519 密钥，其他步骤都不变。

克隆完成后，就可以在本地目录下看到整个仓库的内容，这个作为本地仓库（其实就是 github 上远程仓库的一个分身），我们的修改都先保存在本地仓库，接着使用相关命令就可以 push 到关联的远程仓库啦。

接着按照我们的需要修改本地仓库里面的内容就行。

更多内容请看原文链接：https://blog.csdn.net/rtthreadiotos/article/details/125271685

...全文