[编程新手系列] 关注开源项目,并尝试为开源项目提交代码

翻译 Summer ⋅ 于 3个月前 ⋅ 最后回复由 阿文 2个月前 ⋅ 1148 阅读 ⋅ 原文地址
这是一篇社区协同翻译的文章,已完成翻译,更多信息请点击 协同翻译介绍

作为一个雇主,甚至是一个开发人员,我想看到你对这个行业的热情。最好的方法之一是让我和其他人看到你最喜欢的项目代码。

开放源代码是指代码库可以被任何一个人查看、提交编辑。作为行业中最主要的网站GitHub,它几乎包含了所有的开源项目。

开源项目是参与社区的一个很好的方式--它让你能够与其他开发者互动交流,它可以让你更好地学习代码, 它甚至可以帮助你熟悉那些对初级开发者来说很难的大型代码库。

Linz 翻译于 3个月前

查看其他 1 个版本

但你怎么开始? 首先,我会尝试一些真正的,非常简单的。 去找一个你喜欢的项目,也许这是你最喜欢的 ruby gems (ruby 打包系统) 或者一个 npm 包,并开始阅读代码。 我们不是在寻找逻辑上的缺陷,我们正在寻找拼写错误。 是。错别字。 在评论中输入错字。 你的第一个开源请求将是一个错字纠正。 你会把 reuturns 改成 returns。 你还会把 him 改成 them。 你会改变任何你能找到的微不足道,安全的东西。

但变化并不重要。 重要的是你如何提出改变。 环顾一下,你很可能会找到一个贡献者指南 或阅读我的章节。 这些部分将告诉您如何对代码库进行更改。 如何检查代码,运行它,分支命名约定,公关惯例等。您可能还想阅读上周的代码评论博客,了解如何创建一个伟大的公关。 同时也是与项目维护人员互动的好时机,并且启动这种关系,随着公关力度的增加,这种关系将会有所帮助。

阿文 翻译于 3个月前

查看其他 1 个版本

现在你已经学会了分支(forking)和创建合并请求(pull requests)是如何工作的,该开源一些你自己的项目了。什么项目呢?嗯,你有没有在大学或者训练营时写过的项目?或者某个周末随便写着玩的脚本?或者你在参加某次 hackathon 时写的代码?

代码质量不需要很好(谁知道怎么才算好?!)。先把它放到网上再说。也不需要是完成了的项目。重点是你要行动起来。你也不必写出一份华丽的贡献指南, 一个简单有效的 ReadMe 文件就很有帮助。

1212e 翻译于 3个月前

查看其他 1 个版本

良好的ReadMe文件应该满足以下要求:

  1. 关于项目的描述,比如:项目做什么,解决了什么

  2. 项目的安装方式或者如何运行项目

  3. 使用示例

  4. 他人贡献代码的方式. 可以参考这个 简单示例

  5. 文档,详情,项目技术支持的相关联系方式

  6. 一份已知bug,使用范围或者暂未实现的功能清单列表,尽管它们可以在项目的issues中查找到

  7. 也可以附加一个项目被他人使用的情况,或者是顶级贡献者列表

  8. 如果没有 LICENSE.md文件, 则会默认使用一下协议(MIT, Apache etc). 当然更好的方式是添加一份授权说明,可以在开源协议列表中选择一个你需要的
mojiajuzi 翻译于 3个月前

查看其他 1 个版本

这样那会是一个很棒的开源 ReadMe. 除了代码, 一个好的代码仓库还应该有什么呢? (是的, 我知道, 我的一部分项目也并没有全部做到这些)

  1. 一份 ReadMe 文件

  2. 一份 贡献指南

  3. 一份 错误 模板 

  4. 一份 PR 模板

  5. 一份 许可声明

  6. 一份 代码规范
ouer1994 翻译于 3个月前

接下来,注册个GitHub账号 (免费的)。学习 基础 ,一步一步来!开源让你很好的融入社区,作为一个开发者,让你的技术不断提升。我希望你最幸运!

gaohuag 翻译于 3个月前

原文地址:https://www.samjarman.co.nz/blog/open-so...

译文地址:https://laravel-china.org/topics/7868/no...


本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

本帖已被设为精华帖!
回复数量: 4
暂无评论~~

  请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!