2021-11-10 20:12:41 +08:00
[#]: subject: "4 tips to becoming a technical writer with open source contributions"
[#]: via: "https://opensource.com/article/21/11/technical-writing-open-source"
[#]: author: "Ashley Hardin https://opensource.com/users/ashleyhardin"
[#]: collector: "lujun9972"
[#]: translator: "yingmanwumen"
2021-11-11 10:09:20 +08:00
[#]: reviewer: "wxy"
2021-11-11 10:10:22 +08:00
[#]: publisher: "wxy"
[#]: url: "https://linux.cn/article-13974-1.html"
2021-11-10 20:12:41 +08:00
成为为开源做贡献的技术写手的四个建议
======
2021-11-11 10:09:20 +08:00
> 你的开源贡献将会向潜在雇主表明,你会主动寻求学习、成长和挑战自我的机会。
2021-11-10 20:12:41 +08:00
2021-11-11 10:09:20 +08:00
![](https://img.linux.net.cn/data/attachment/album/202111/11/100737uebjijhwz0l4zhoo.jpg)
不管你是一个对技术写作有所涉足的技术爱好者,还是一个想要转职为职业技术写手的成熟技术专家,你都可以构建你的技术写作作品集,并将你的开源贡献作为作品集的一部分。为开源项目写作是一件有趣、灵活且低风险的事情。按照自己的时间安排来为你感兴趣的项目做贡献,你将会为社区是多么热情或你对社区产生影响的速度而感到惊喜。
你的开源贡献将会向潜在雇主表明,你会主动寻求学习、成长和挑战自我的机会。和任何事情一样,你需要从某个地方开始。为开源项目做贡献可以让你在展示你的才华的同时学到新技巧、新技术。另外,为开源项目写作能让你接触到新的社区、跨越时区与新鲜面孔合作,并建立你的社交网络。当你挖掘到新的开源机会后,你的简历将更抢眼,让你在其他候选人中脱颖而出。以下是为开源做出贡献的四个建议,这可以让你走向技术写作的职业生涯。
2021-11-10 20:12:41 +08:00
### 学习行业工具
2021-11-11 10:09:20 +08:00
作为开始,我建议先熟悉 [Git][2],并建立 [GitLab][3] 和 [GitHub][4] 帐号,然后寻找一个趁手的文本编辑器。我个人喜欢使用开源工具 [Atom][5]。关于 Git, 它能从网络上获取到丰富的免费学习资源, 包括一些优秀的互动教程。你不需要成为一个 Git 高手才能深入开源世界。我建议先学习一些基本操作,然后让你的技能随着你的贡献逐渐成长。
2021-11-10 20:12:41 +08:00
### 找到一个项目
2021-11-11 10:09:20 +08:00
为开源做贡献最难的部分大概是找到一个项目来做贡献。你可以查看 [Up For Grabs][6] 并找一些感兴趣的项目。[First Timers Only][7] 有更多的起步资源。别犹豫,联系项目维护者来了解更多有关于项目的东西,并了解他们在何处需要帮助。请坚持下去。找到一个适合你的项目可能会花费一些时间。
2021-11-10 20:12:41 +08:00
### 告别“冒充者综合症”
2021-11-11 10:09:20 +08:00
一个常见的误区是你必须是一个程序员才能为开源项目做贡献。作为一个没有工程或计算机科学领域有关证书的、自学成材的贡献者,我能保证事实并非如此。文档往往开发项目中最价值但最被忽视的部分。这些项目经常缺少人手和资源来建立完善的、高质量的文档。这给你展现了一个绝佳机会来参与提交拉取请求或归档该项目的议题。你可以做到的!
2021-11-10 20:12:41 +08:00
2021-11-11 10:09:20 +08:00
( LCTT 译注:< ruby > 冒充者综合症< rt > Impostor Syndrome< / rt > < / ruby > ,又称自我能力否定倾向,指个体按照客观标准评价为已经获得了成功或取得成就,但是其本人却认为这是不可能的,他们没有能力取得成功,感觉是在欺骗他人,并且害怕被他人发现此欺骗行为的一种现象。)
2021-11-10 20:12:41 +08:00
### 从小处开始
2021-11-11 10:09:20 +08:00
查看你感兴趣的项目的仓库,找到可能存在的贡献指南并遵循。然后,寻找更新 README 文档或提交修改错别字的机会。没有什么贡献是微不足道的。项目维护者可能会为这些帮助感到高兴,而你也将会因把你提交的第一个的拉取请求收录进你的技术写作作品集而感到愉悦。
2021-11-10 20:12:41 +08:00
--------------------------------------------------------------------------------
via: https://opensource.com/article/21/11/technical-writing-open-source
作者:[Ashley Hardin][a]
选题:[lujun9972][b]
2021-11-10 20:13:59 +08:00
译者:[yingmanwumen](https://github.com/yingmanwumen)
2021-11-11 10:09:20 +08:00
校对:[wxy](https://github.com/wxy)
2021-11-10 20:12:41 +08:00
本文由 [LCTT ](https://github.com/LCTT/TranslateProject ) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
[a]: https://opensource.com/users/ashleyhardin
[b]: https://github.com/lujun9972
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/rh_003784_02_os.comcareers_resume_rh1x.png?itok=S3HGxi6E (A person writing.)
[2]: https://git-scm.com/
[3]: https://about.gitlab.com/
[4]: https://github.com/
[5]: https://atom.io/
[6]: https://up-for-grabs.net/#/
[7]: https://www.firsttimersonly.com/