该文档指导大家参与openEuler社区。
欢迎来到openEuler!
欢迎来到openEuler!
您必须首先签署“贡献者许可协议”(CLA),然后才能参与社区贡献。
openEuler是一个开源社区。它完全依赖于社区提供友好的开发和协作环境,所以在参与社区贡献之前,请先阅读并遵守openEuler社区的行为守则。
随时欢迎您的加入!
在社区上总是有可以改进的文档(比如您正在阅读的),需要检视的代码,可以重构或注释的函数或变量,可以持续补充和优化的测试用例。我们将帮助您了解openEuler SIG的组织方式,并引导您顺利的开始您的第一个贡献。所以如果您感兴趣,现在就行动吧。
SIG就是Special Interest Group的缩写,openEuler社区按照不同的SIG来组织,以便于更好的管理和改善工作流程。
找到您感兴趣的SIG组,可以帮助您在正确的地方提出问题,并得到更快的社区响应。
方式一:如果您不了解有哪些SIG或项目,您可以查看SIG列表,它包含当前openEuler社区成立的所有SIG团队的清单。您可以通过该列表快速的定位到您感兴趣的领域所对应SIG团队。同时还为您提供该SIG团队的如下信息:
方式二:如果您知道感兴趣的项目名称,可以在openEuler的Repository列表下进行模糊搜索,从而快速定位到对应项目的首页地址。通常情况下,在该项目首页地址的README.md
文件中,可以找到该项目所属的SIG信息、交流方式、成员和联系方式等。
如果上述两种方式都定位不到您感兴趣的SIG,您可以向community@openeuler.org发求助邮件。建议您在邮件列表内用“【开发过程疑问】”作为标题,在内容中写出你寻找的SIG或项目的特征,我们会为您提供帮助。
找到Issue列表:在您感兴趣的项目的首页内(Gitee上的项目的Repository)的工具栏,点击,您可以找到该SIG的Issue列表(如Community团队的Issue列表地址为https://gitee.com/openeuler/community/issues)
找到愿意处理的Issue:如果您愿意处理其中的一个issue,可以将它分配给自己。只需要在评论框内输入 /assign
或 /assign @yourself
,机器人就会将问题分配给您,您的名字将显示在负责人列表里。
参与Issue内的讨论:每个Issue下面可能已经有参与者们的交流和讨论,如果您感兴趣,也可以在评论框中发表自己的意见。
如果您想参与编码贡献,需要准备openEuler的开发环境,请参考开发环境准备
如果您想下载、修改、构建及验证openEuler提供的软件包,请参考构建软件包
每个SIG内的项目使用的编码语言、开发环境、编码约定等都可能存在差异。如果您想了解并参与到编码类贡献,可以先找到该项目给开发者提供的贡献者指南——这个指南一般是在该SIG的首页地址内,以CONTRIBUTING.md
文件的形式提供,或者就直接在该项目的README.md
内(如何找到项目的Repository,请参考上一节的内容)。
除了这些文件外,SIG可能还会提供其他指南信息。这些信息位于SIG或其项目的特定社区目录中。如果您未找到相关信息,或者对相关信息有疑问,可以在该SIG内提交Issue,或者把问题或疑问发送到该项目所属SIG的邮件列表。如果您认为长时间没有得到回应,可以向community@openeuler.org求助。
如果要参与代码贡献,您还需要了解如何在Gitee下载代码,通过PR合入代码等。openEuler使用的是Gitee代码托管平台,向了解具体的指导,请参考Gitee Workflow Guide。该托管平台的使用方法类似GitHub,如果您以前使用GitHub,本章的内容您可以大致了解甚至跳过。
在本地分支上完成修改后,进行构建和本地验证,请参考构建软件包。
当你提交一个PR的时候,就意味您已经开始给社区贡献代码了。请参考openEuler社区PR提交指导。
openEuler支持在gitee新增软件包的同时自动在EulerMaker创建对应工程。这样在向已创建的gitee仓库提交代码时,会自动对代码编译进行检测。具体流程可参考如何新增软件包。
openEuler是一个开放的社区,我们希望所有参与社区的人都能成为活跃的检视者。可以参考社区成员,该文档描述了不同贡献者的角色职责。
对于贡献者,为了使您的提交更容易被接受,您需要:
对于检视者,强烈建议本着行为准则,超越自我,相互尊重和促进协作。在检视其他人的PR的时候,补丁审核的柔和艺术提出了一系列检视的重点,旨在说明检视的活动也希望能够促进新的贡献者积极参与,而不会使贡献者一开始就被细微的错误淹没,所以检视的时候,可以重点关注包括:
注意:如果您的PR请求没有引起足够的关注,可以在SIG的邮件列表或dev@openeuler.org求助。
为了成功发行一个社区版本,需要完成多种测试活动。不同的测试活动,测试代码的位置也有所不同,成功运行测试所需的环境的细节也会有差异,有关的信息可以参考测试指南。
您也可以参与社区组件打包,请参考:如何打包
如果您的兴趣不在编写代码方面,可以在非代码贡献指南中找到感兴趣的工作。
openEuler社区的交流方式有邮件列表、IRC会议和视频会议等,使用方式请参考社区交流方式指导
openEuler参加或举办的社区和技术交流会议,关于这些事件和其他社区事件信息均可以在openEuler新闻页面上找到
社区每年会定期举办开发者大会,您可以通过https://openeuler.org上的信息或通过电子邮件dev@openeuler.org与我们联系。来加入我们吧~
如果您在使用该贡献者指南或对开发过程有疑问,请随时告诉我们,并在邮件标题内用“【开发过程疑问】”作为邮件标题写出你的疑问和困惑,openEuler社区运营团队会并尽力确保您的问题得到解答。
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )