如何为OpenHarmony贡献(4):来自翻译的视角#如何打造活跃的开源社区-五个关键步骤
  mtRD5tHiQWm1 2023年11月02日 91 0

步骤一:让开源项目简单易用

一个出色的开源项目应包含什么?

●       技术资料?

●       Readmes?

●       API?

●       Sample code?

答案是:所有的一切!

类似写出好的代码,开发好的资料需要付出巨大的努力。一些好的做法:

●       写作的资料要有吸引力、透明。

●       对项目的各个方面进行全方位的介绍说明。

●       包括如何使用该代码的示例。

●       定期更新文档,确保文档与技术同步。

●       文档应便于开发者贡献。


步骤二:清晰解释开发者如何贡献

对您的开源项目感兴趣的开发者需要充足的信息帮助Ta们入门并高效开展开发活动。应避免开发者花费时间搜索Ta们需要的资料。因此,可以在《如何参与贡献》的说明文档中提供专门的章节予以说明。根据GitHub93%的人认为“不完整或过时的文档”是一个关键问题。文档质量是其放弃的一个主要原因。

一些Tips:

●       尽可能清晰、简单地解释如何在您的社区如何做出贡献。

●       创建《如何参与贡献》文件并保持文档最新。

●       准确的标记您的文档,以便新手可以轻松检索到您的项目并快速启动。例如,'for newbies',‘for work horses’等。

●       让进入您的开源项目的人感受到被欢迎。感谢Ta们对开源项目的兴趣和投入。说几句好话'可以有助于在Ta们要放弃您的项目时回心转意。

步骤三:构建个人关系

互联网协作往往会感到孤独和缺少人情味。如果你要与所有开发者远程协作,你需要建立更密切的关系。应当让开发者如何通过开发者社区了解实实在在的你,而不仅仅是一个冷冰冰的Gitee或GitHub帐户。

一些Tips:

●       建立沟通渠道,提供实时沟通工具等。例如,Discord是一个免费的开源语音和文字聊天工具。它是为游戏玩家设计的,但是开发者发现它对于他们的开源项目来说是一个非常有用的工具。它能促进思想的分享、提问和形成人际关系。

●       欢迎新来者加入团队,让Ta们了解当前的生态发展现状。

●       识别最佳的贡献者,帮助Ta们进步。邀请他们聊天和电话,扩大他们对平台的了解。考虑将他们推荐给个人和公司进行协作。你的社区成员成长越快和技能提升越多,你的平台将拥有更多的专家。

步骤四:让开发者感受到包容

如果在开源社区感到包容,开发者可能会更愿意为项目做出贡献。我们越能让别人觉得是这个项目的一部分,Ta们就会越积极主动地与你共度难关。

一些Tips:

●       倾听Ta们的反馈,无论是正面的还是负面的。您可能会在hard-to-hear的反馈中找到最有用的信息。

●       确保Ta们能通过不同的渠道与您沟通。

●       考虑制定一个开发着邮件名单列表,以便向用户提供持续的信息。订阅该列表的每个人都会收到最新的博客帖子、公开发布和重要公告等信息。

●       写博客,感谢社区贡献者。

●       与其修正一些简单的错误,不如指导一个愿意贡献的开发者。

●       在开源项目中包括一个贡献者列表文件,列出每个贡献者。

●       让最值得信赖的贡献者成为开源项目的维护者。给予Ta们Commit权限,并给Ta们机会将项目做到专业标准。

步骤五:制定行为守则

开源项目可能吸引来自于世界各地的人们。人员多样性是导致开源社区重大冲突的一个重要原因。根据GitHub调查报告显示,开源项目中用户之间的负面交互非常普遍。近18%活跃于开源社区的用户曾与他人有过负面互动;有50%的用户表示曾见证过Ta人之间负面交流。最常见的负面互动是无礼、骂人、刻板印象。高达21%的用户表示,他们因为负面互动而停止了对开源项目的贡献。因此,您的开源社区需要为所有用户提供无骚扰、无歧视的体验,无论其年龄、种族、性别、国籍、性取向或宗教。

一些Tips:

●       快速解决负面事件,留住贡献者并促进相互协作。

●       礼貌并公开地处理负面的互动。您应向贡献者传递这样一个信息:在您开源项目中任何个体不会遭受到负面对待。

●       提供对抗负面互动和自我保护自己的工具。屏蔽Ta人是最有效的方法之一。

●       将行为守则在开源社区进行公示。在《如何参与贡献》或者Readme中提供链接索引。

●       Contributor Contract的开源项目提供了一种行为准则,可帮助我们在开源项目解决文明、骚扰和歧视的问题。


参考:

●       How to Build a Vibrant Open-Source Community in 5 Steps(https://adevait.com/blog/workplace/build-open-source-community

【版权声明】本文内容来自摩杜云社区用户原创、第三方投稿、转载,内容版权归原作者所有。本网站的目的在于传递更多信息,不拥有版权,亦不承担相应法律责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@moduyun.com

  1. 分享:
最后一次编辑于 2023年11月08日 0

暂无评论

推荐阅读
mtRD5tHiQWm1