担任维护员第一周学到的 5 件事
精炼 GitHub
我暂停了一周的博客写作,这期间发生了一些变化。我加入了 Gatsby,一夜之间成为了一名开源项目维护者。😳
因此,过去一周我收获了很多新的体验。我想分享一些我学到的东西,或许对其他人也有用。
-
Github UI 技巧!
事实证明,Github 的文档非常精彩,这对我来说非常有价值,因为我学会了如何以新的方式使用 UI。
对于审查拉取请求 (PR),使用“文件更改”选项卡非常有帮助。尤其是对于包含多个提交或多个文件的 PR。
另一个我喜欢的技巧是逐行注释更改。我以前提交过 PR,也见过类似的编辑,但直到现在我才真正明白它是如何做到的。 -
Upstream 不是 git 关键字
另一个我喜欢的技巧来自我的新老板@marcysutton。我之前曾 fork 过仓库并设置过上游仓库。但是,当我按照文档操作时,我从未意识到那upstream
不是一个必需的关键字,而只是一个变量名。
这非常有价值,因为 Github UI 功能强大,但这并不总是足够的。在某些情况下,我想下拉贡献者的更改以便在本地运行它们。由于upstream
只是一个名称,我可以使用贡献者的名字来代替。这使得跟踪多个 fork 变得更加容易。顺便说一句,这就是为什么在学习教程时更改名称如此有用。这样你就能了解哪些是可替代的,哪些不是。
-
注重细节
审核 PR 时需要考虑很多方面!我属于学习团队,因此我会从技术角度检查信息是否准确、是否写得清晰、是否遵循我们的风格指南以及其他一些方面。
过于关注其他方面很容易忽略其中一项。此外,审核每个 PR 时都会着眼于整个项目,而作为新手,我还不了解我们所有的文档、功能或任何方面!
因此,快速上手绝对是一个挑战。但很棒的是,我可以对发现的内容发表评论,其他团队成员也可以贡献自己的力量。这就是开源在工作中的美妙之处。 -
所有人都注视着你
开源的一大隐患在于,你的所有工作都公开,每个人都知道你什么时候犯错。但我很快就意识到,项目进展如此之快,PR 如此之多,根本无法追踪。所以请放心,没有人会评判你的贡献,只会审核它们是否与项目保持一致。
如果你需要更多证据,我给你我的第一个 PR。还带点错字……🤦🏻♀️证据 -
开源永不眠。Hacktoberfest
是开源项目一年中最繁忙的时期之一。即便如此,我的 Github 邮件通知也一直没完没了。我喜欢完成任务,所以这对我来说需要调整一下。我永远不会“完成” PR 的审核,因为总会有新的 PR 涌入。
将 PR 审核视为一项有时间限制的活动非常重要。这样,我就可以推进我们的长期计划,而不是像在传送带上扮演 Lucy 一样。
这些只是我第一周的一些零散想法。但我希望这能让我更好地了解我的新角色。祝你维护愉快!
文章来源:https://dev.to/laurieontech/5-things-i-learned-in-my-first-week-as-a-maintainer-1khc