国内开源项目很少注释_开源新人很少问，但常常感到奇怪

最新推荐文章于 2020-12-02 08:01:36 发布

cumo3681

最新推荐文章于 2020-12-02 08:01:36 发布

阅读量307

点赞数

文章标签：大数据编程语言 python 人工智能 java

原文链接：https://opensource.com/life/14/2/newcomer-frequently-asked-questions

版权

国内开源项目很少注释

开源来到校园是OpenHatch举办的活动系列，向大学生介绍开源工具，项目和文化。 每当我们在活动中遇到新问题时，我们都会将其写下并在博客上更全面地回答。 这是“不常见问题”的集合，这些问题与新手开源项目特别相关。

在开源文章中查看完整的初学者集合

问：我很新，我担心我会成为一个项目的负担。一个项目必须做出什么样的努力来建立一个开源社区？

答：首先，您应该知道，像Linus Torvalds这样的开放源代码专业社区构建者了解培训新贡献者与从现有维护者指导他们所花费的时间之间的紧张关系。我将引用2004年Linus在Linux内核列表上发表的两段文章：

Jesper Juhl在2004年12月21日星期二写道：

我是否应该停止尝试进行这些琐碎的清理/修复/任何补丁？ 他们比收获更讨人喜欢吗？ 我是不是对lkml上比较熟练的人很痛苦，还是你们都可以忍受我有时甚至很无知的补丁？ 我确实尝试从收到的反馈中学习，并且我想认为我的补丁逐渐变得更好，但是如果我不但没有帮助，还不如停止。

莱纳斯回答：

对我而言，具有小补丁的最大功能不一定是补丁本身。 我认为，比起补丁程序，更重要的是，人们已经习惯了可以更改内核的想法，而不仅仅是在知识上（“我了解GPL意味着我有权更改内核”）。，但在更实际的水平上（“嘿，我做了那么小的更改”）。

要记住的另一件事是，对于大多数项目，项目负责人是唯一的贡献者（来源）。考虑一下：以新手的身份来烦扰他们的行为会使他们对整个项目更加热情！

如果构建一个易于访问的开源社区很简单，那么几乎所有项目都可以做到。需要付出一些努力。当然，许多使项目受到新手欢迎的工作-良好的文档和设置指南，维护良好的问题跟踪器，积极的开发，社区的行为标准-使该项目对每个人都更好。但这确实需要时间和精力，许多项目社区都不愿意花费时间和精力。这就是OpenHatch存在的原因！我们知道有些项目为欢迎贡献者付出了更多的努力，我们希望帮助您找到这些项目。

那些欢迎新来者的项目不会将您视为负担。他们将您视为巨大的帮助-即使您在努力理解问题跟踪器中的错误或设置开发环境时，也是如此。当您向开源项目的成员寻求帮助时，这会为他们提供有关项目的哪个部分令人困惑或不正确的重要信息。您提出的问题和需要的指导使他们知道以后如何帮助他人。当然，一旦您熟悉了该项目，便可以提供更多帮助。正确的项目类型会发掘您的潜力，并希望与您合作实现目标。

对于担心太麻烦的人（有的话，有时包括我们！）有两个经验法则：首先，如果邮件列表或错误跟踪器上的人没有告诉您停止讲话，那么您可能好的，即使他们尚未回复您。其次，如果您想发表其他意见，只需加入#openhatch IRC频道并询问我们。

问：开源项目如何审查更改，这些更改与Wikipedia这样的过程有何不同？

答： Wikipedia的一个重要文化元素（至少到目前为止）是，任何人对English Wikipedia的编辑都会立即成为该百科全书的实时版本的一部分。相比之下，为了保持质量，开源项目通常只允许少数人直接将更改合并到主项目中。因此，提交的更改要经过审查。

不同的社区有不同的标准和流程。有时，根本没有审查，只是维护者自动合并。在其他情况下（例如Linux），提交内容将进入邮件列表进行审查。其他人，例如OpenHatch网络应用程序，则使用基于Web的工具，例如GitHub拉取请求。 OpenStack Gerrit Workflow文档页面是更复杂的过程的绝佳参考。

图片CC BY-SA

问：当您忙于学习时，您如何花时间为开源做贡献？

答：仅使用开放源代码程序，您就可以为其他用户提供独特的定位。不要忘记，帮助人们使用该软件对社区做出了巨大贡献！通过成为所使用程序的专家，您还将获得知识，以帮助将其他人提交的错误转换为主要开发人员可以采取行动的报告。一旦达到这一点，您可能会发现更容易解决该问题！

也就是说，在已经充斥着课程，有偿工作和学生生活的日程安排中添加另一个活动可能会令人生畏。处理开放源代码的一种方法是，将其视为完成学业的替代方法，而不是将其视为学业的替代方法。对于计算机科学专业的学生来说，开源项目是实践课堂上所学概念的绝佳方法。在其他科学领域，学习如何使用开源工具，例如R或Octave（或ImageJ或PsychoPy或JMARS）并为之做出贡献，可以帮助您在进行实验室工作时脱颖而出-简历看起来很棒。即使在艺术和人文科学领域，学习诸如Processing之类的开源工具也可以帮助您成功。

对于在学校工作的学生来说，开源项目可以成为潜在的雇主。您可以申请Google Summer of Code或GNOME外联计划，并在开源项目中进行带薪实习。从事开源工作的各个公司可能会雇用表现出足够兴趣和能力的学生。您甚至可以使用开放源代码来雇用自己，例如，您可以使用WordPress和Drupal等开放源代码工具从事网站和应用程序的自由职业。

您也可以使开源成为您社交生活的一部分。加入（或开始）校园里的“免费学生文化”一章，或邀请朋友参加“错误修复派对”。

最后，请记住，您对开源的贡献可以与您想要的一样大。如果您每个月只有时间花几个小时编写文档或修复项目中的小错误，那就太好了-如果您决定参与进来，那么您正在学习的技能和正在建立的联系将为您服务。

问：开发人员的源代码下载与用户的源代码下载有什么区别？什么是稳定版本？

答：开源项目通常以几种不同的方式发布程序。通常，如果您要提供帮助，则需要从项目的版本控制系统中克隆或“检出”最新的源代码。如果您只是尝试使用该程序，则通常需要面向用户的下载。

许多程序的源代码无法在计算机上直接执行-必须对其进行“编译”，这会将其从人类可读的文本转换为机器可执行的二进制代码。正确的最常见语言是Java，C和C ++。因此，对于想要运行像OpenOffice这样的项目（主要是用C ++编写）的人来说，最有用的下载将是特定于他们的操作系统的编译版本（例如，特定于Windows的版本）。相反，如果您想为程序做出贡献，则应采取与主要开发人员的行为类似的方式，即在可编辑程序文本（即源代码）上使用版本控制系统。

另一个重要概念是稳定发布。在开发过程中，人们做出的贡献破坏了程序，与其他变更发生冲突或只是未完成。在任何给定的点上，最新版本可能完全不可用。因此，维护人员会定期进行发布（名词）的发布，这些发布经过测试以确保它们是可用的。如果是，则维护者释放它（动词）。

因此，如果您是用户，则需要最适合您的操作系统和计算机的稳定版本。如果您想提供帮助，则需要最新的未编译版本。

图片CC BY-SA

问：是否所有开源项目都欢迎新来者？您如何知道项目周围的社区何时充满了混乱？

答：并非所有开源项目都欢迎新来者。并非所有开源项目都需要。一些项目得益于保持社区规模小和经验丰富。而且，一些维护者根本没有精力或倾向去指导新人。

这样做没有错，但是当新来者尝试参与对他们不感兴趣的项目时，这是一种耻辱。对于每个人来说，这都是令人沮丧的体验，当有很多人愿意与他们合作时，这是不必要的。

那么，您如何才能找到一个适合新来的人的好项目呢？以下是一些好的征兆：

一个活跃的大型社区更可能拥有一些可以花时间指导的成员。这也意味着将更快地采取行动。
好的文档和演示说明开发人员已经考虑过如何将人们介绍给他们的项目。
一些项目有行为准则/多样性声明，表明社区正在努力成为一个安全而温馨的场所。
属于Google Summer of Code或GNOME妇女外展计划的一部分的项目已承诺为新移民提供良好的环境。

在OpenHatch，我们尝试确定特别适合新手的项目。我们还正在开发与OpenHatch相关的项目的列表，这些项目正在与我们合作，以尽可能轻松地为他们的项目做出贡献。（如果您想进入该列表，请告诉我们！）请随时与我们联系并向我们提出建议，或者是否知道某个特定项目对新来者有好处。

图片CC BY-SA

当然，在没有时间和精力帮助新来者与积极地刻薄甚至辱骂之间有区别。如果您遇到了后者，并且我们很乐意告诉我们，我们将尽力为您提供支持。 OpenHatch员工总是愿意就加入的项目提供建议，以帮助您找到很棒的经验或充分利用不好的经验。在IRC上找到我们（irc.freenode.net上的#openhatch），或通过hello@openhatch.org向我们发送电子邮件。您还可以加入Systers或Empowermentors Collective之类的组，这可以帮助您浏览自由软件社区。