2017开源大调查：每天在Github上默默贡献的都是什么人

正文

请到「今天看啥」查看全文

文档很重要，但经常被忽视

文档有助于指导新用户：如何使用项目，如何贡献，使用和贡献的条款，以及社区的行为标准等。改进文档是回馈开源的一个很好的方式。

93％的受访者表示，不完整或过时的文档是一个普遍存在的问题，但60％的贡献者表示很少或从未对文档做出贡献。当你遇到文档问题时，请发起一个 pull quest 来帮助改进文档。

许多人在工作中参与开源，因此对使用条款的信赖至关重要。毫不奇怪，到目前为止许可证书对用户和贡献者来说都是最重要的文档类型：64％的用户认为开源许可对他们决定是否使用该项目非常重要，67％的用户认为在决定是否提供贡献方面非常重要。

文档对创建包容性的社区有帮助。明确说明一个项目的进度的文档，例如贡献指南和行为准则，对在开源中参与不足的群体（例如女性群体）更加重要。

近四分之一的开放社区用户在英语的读写方面不是畅通无阻的。因此在针对项目进行沟通时，请对非英语母语者或读写障碍者使用清晰易懂的语言。

图1：使用开源时遇到的问题

负面的互动不常见，但很突兀，对项目的活动有影响

开源社区有来自世界各地的人，因此可能导致冲突。虽然严重的冲突事件很罕见，但开源的公开性质使得负面的相互作用非常突兀。

因此，负面影响的可能远不止直接参与的个人。对用户行为提出积极的建议，并迅速解决负面事件，可以增加贡献者的参与和协作。

18％的受访者亲自与其他开源使用者产生过负面的互动，但有50％的受访者亲眼目睹过其他人的冲突。从这些数据我们无法得知，这两个数字的差距是否是因为经历过这种冲突的用户离开了开源社区，或只是因为冲突广泛存在，因此目睹者多。无论哪种，都是受负面互动影响者比直接参与冲突者多，所以快速、礼貌并且公开地解决这类问题，也是在向潜在的目睹者发送了一个信号，即这种行为不是普遍的，而且是不能容忍的。

到目前为止，最常见的不良行为是粗鲁言语的（45％目睹过，16％经历过），其次是辱骂（20％目睹过，5％经历过）和成见（11％目睹过，3％经历过）。不到5％的受访者遇到更严重的负面事件，例如性骚扰或跟踪，经历者不到2％（但累计目睹者为14％，经历过的3％）。

负面经历对项目健康发展有严重的后果。21％的经历过或目睹过负面行为的受访者表示，由于这种情况，他们停止了对项目的贡献，8％的人变得更喜欢在私人渠道贡献。

请到「今天看啥」查看全文