第一次给别人的项目提改动：开源贡献入门
前面几期，你都是在自己建的仓库里动手：改一改说明、开一个 Issue、发一个 Pull Request。
0:00 / 10:37
第一次给别人的项目提改动：开源贡献入门
这期节目带你在浏览器里完成第一次真正的开源贡献：把一个不属于你的项目复制到自己名下，加上一行你自己的改动，再提一个 Pull Request 把它送回原项目。
本期要完成的练习
- 练习场地：开源项目
firstcontributions/first-contributions，一个专门接纳新手第一次贡献的真实仓库。 - 你的改动：在它的
Contributors.md列表中间，加一行自己的名字；就这一行，不多不少。 - 交付结果：向这个项目提一个 Pull Request，方向是"你副本里的分支 → 原项目的
main"。
开源贡献（open source contribution）说的是把开源项目里需要的东西补上。代码只是其中一种，改进文档、做翻译、报告问题、帮忙测试，都算贡献，门槛还比写代码低。1
first-contributions 这个仓库存在的目的，就是把新手第一次贡献的门槛降到最低：按它的说明加一行名字，走一遍完整的贡献流程。2浏览器操作步骤
- 打开 firstcontributions/first-contributions，先读它的说明页，它提供包括中文在内的多语言版本。3
- 点右上角的 Fork，再点 Create fork。Fork 会在你的账号下生成一份副本，你改的是副本，不会动到原项目。4
- 在你的副本里打开
Contributors.md，点右上角的铅笔图标 Edit this file。 - 把光标放到列表中间，新起一行，照抄上面一行的格式，把名字和账号链接换成你自己的。不要加在文件的开头或结尾。3
- 滚到页面底部，在 Commit changes 里写提交说明
Add <你的名字> to Contributors list，选 Create a new branch for this commit and start a pull request，分支名写add-your-name，再点 Propose changes。 - 进入比较页面，确认方向：base repository 选
firstcontributions/first-contributions、base 分支选main；head repository 选你自己的副本、compare 分支选你刚建的那一条。5 - 标题写
Add <你的名字>，描述用一句话说明你做了什么，点 Create pull request。
提了 PR 之后怎么检查
- 看方向：页面上 base 要是原项目的
main，head 要是你副本里的分支。方向反了，就等于提给了自己，维护者那边看不到。5 - 看内容：Files changed 里应该只有你加的那一行。
- 看状态：先是 Open；维护者合并之后才会关闭并显示 Merged，你的名字这时才出现在原项目的列表里。Pull Request 不会自动合并。6
- 有反馈会发到你的邮箱。要改，就在原来那条分支上改，Pull Request 会自动更新，不要另开一个。6
- 等了一段时间没人回应，可以礼貌地在下面留一句问一下；不要点名催促维护者。6
常见误区
- 把 Fork 当成收藏。收藏用 Star；Fork 是把项目复制到你名下，用来改的。4
- 想直接在原项目上改。你没有它的写权限，必须先在副本里改，再提 Pull Request。4
- 名字加在文件开头或结尾。这个列表是所有人共用的，加在中间，大家的改动才不会互相顶掉。3
- Pull Request 方向选反。base 必须是原项目，不是你自己的副本。5
- 以为 Pull Request 会自动合并。它先是一份等待审查的请求，合不合，由维护者决定。6
- 不看贡献规则就动手。每个项目都有自己的规矩，先读 README、CONTRIBUTING、行为准则和 LICENSE，你的改动被接受的机会更大。67
- 抢别人正在做的任务。看到想做的 issue，先在那条 issue 下面留言说你来做，避免重复劳动。7
- 把只能私下说的内容放进公开沟通。开源项目的讨论尽量留在公开的 issue 或 Pull Request 里，其他人也能一起看到。7
下一步练习
- 用
good first issue和help wanted这类标签，在 GitHub 探索页 或一个你感兴趣的话题里挑三个项目，只读它们的 README 和 CONTRIBUTING，各找一条新手任务，先不提交。18 - 回看你提的那个 Pull Request。等它被合并，再打开原项目的
Contributors.md，找到你写下的那一行。
开源贡献不是一步登天，而是一条固定的顺序：先找到合适的项目、读懂它的规矩，再用一次很小的改动把它走通。
References
- 1
- 2
- 3first-contributions 中文说明 - GitHub
github.com
- 4Fork a repository - GitHub Docs
docs.github.com
- 5Creating a pull request from a fork - GitHub Docs
docs.github.com
- 6Contributing to open source - GitHub Docs
docs.github.com
- 7如何为开源做贡献 - Open Source Guides
opensource.guide
- 8
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.