diff --git a/content/en/developer.md b/content/en/developer.md index 2f0b83f6da02d44586c52e500372e393b2a7d81e..5a73c324ccfa0112461cd925411e49f28d0e9e84 100644 --- a/content/en/developer.md +++ b/content/en/developer.md @@ -35,8 +35,7 @@ Welcome to openEuler! - [Community Security Issue Feedback](#Community_Security_Issue_Feedback) - [Participating in Community Activities](#Participating_in_Community_Activities) - [Communication Methods in Community](#Communication_Methods_in_Community) - - [Community News and Events](#Community_News_and_Events) - - [Community Gatherings](#Community_Gatherings) + - [Community Events](#Community_Events) - [Feedback](#Feedback) @@ -96,7 +95,7 @@ Find a SIG you are interested in so that you can raise questions in the right pl - If you cannot locate the SIG that you are interested in using either of the preceding methods, send a help email to community@openEuler.org. You are advised to use [Question of Development Process] as the title in the email and write down features of the SIG or project you are looking for. We will help you. + If you cannot locate the SIG that you are interested in using either of the preceding methods, send a help email to . You are advised to use [Question of Development Process] as the title in the email and write down features of the SIG or project you are looking for. We will help you. @@ -104,7 +103,7 @@ Find a SIG you are interested in so that you can raise questions in the right pl ### Assigning an Issue to Yourself -- **Finding an issue list**: Click **Issues** to find the SIG issue list (for example, the issue list address of the community team is https://gitee.com/openEuler/community/issues). +- **Finding an issue list**: Click **Issues** to find the SIG issue list (for example, the issue list address of the community team is ). - **Assigning an issue**: If you want to process one of the issues, you can assign it to yourself. Enter `/assign` or `/assign @yourself` in the comment box. The robot will assign the issue to you and your name will be displayed in the owner list. - **Discussing an issue**: Participants communicate and discuss on each issue page. You can leave your opinions in the comment box. @@ -143,7 +142,7 @@ If you want to download, modify, build, and validate the software packages provi The coding language, development environment, and coding conventions used by projects may vary in each SIG. If you want to know and participate in the code contribution, find the contributor guide provided by the project for developers. This guide is generally provided as the `CONTRIBUTING.md` file on the SIG home page, alternatively, you can find it in the `README.md` file of the project. (For details about how to find the repository of the project, see [Finding Your Interests](#Finding_Your_Interests).) -In addition to these files, the SIG may provide other guidance information which is located in the specific community directory of SIG or project. If you do not find any related information or have any questions, submit an issue in the SIG or send the question to the mail list of the SIG to which the project belongs. If you do not receive any response for a long time, contact community@openeuler.org. +In addition to these files, the SIG may provide other guidance information which is located in the specific community directory of SIG or project. If you do not find any related information or have any questions, submit an issue in the SIG or send the question to the mail list of the SIG to which the project belongs. If you do not receive any response for a long time, contact . @@ -220,14 +219,8 @@ The openEuler community supports communication through mail lists, IRC, and vide -### Community News and Events -The information about openEuler community and technical communication meetings and other community events can be found on the [openEuler News](https://openeuler.org/en/news.html) page. - - - - -### Community Gatherings +### Community Events The community holds developer conferences every year. You can contact us by sending emails to or sending messages to [https://openeuler.org](https://openeuler.org). Join us! @@ -235,4 +228,4 @@ The community holds developer conferences every year. You can contact us by send # Feedback -If you have any questions about the developer guide or the development process, please feel free to contact us (community@openEuler.org), use [Question of Development Process] as the title, and write down your questions and doubts in the email. The openEuler community operation team will try the best to answer your questions. \ No newline at end of file +If you have any questions about the developer guide or the development process, please feel free to contact us (), use [Question of Development Process] as the title, and write down your questions and doubts in the email. The openEuler community operation team will try the best to answer your questions. \ No newline at end of file diff --git a/content/zh/developer.md b/content/zh/developer.md index b74d6c7b25e74af23e47cab2511bfc2f8ac5c169..7ebe2f47ba69386559bde1440a76570058dc67ba 100644 --- a/content/zh/developer.md +++ b/content/zh/developer.md @@ -35,8 +35,7 @@ title = "社区贡献" - [社区安全问题反馈](#社区安全问题反馈) - [参与社区活动](#参与社区活动) - [社区内沟通方式说明](#社区内沟通方式说明) - - [社区新闻和大事件](#社区新闻和大事件) - - [社区聚会](#社区聚会) + - [社区活动](#社区活动) - [问题反馈](#问题反馈) @@ -49,13 +48,13 @@ title = "社区贡献" ## 签署CLA -您必须首先签署[“贡献者许可协议”（CLA）](https://openeuler.org/zh/cla.html)，然后才能参与社区贡献。 +您必须首先签署[“贡献者许可协议”（CLA）]()，然后才能参与社区贡献。 ## 社区行为守则 -openEuler是一个开源社区。它完全依赖于社区提供友好的开发和协作环境，所以在参与社区贡献之前，请先阅读并遵守openEuler社区的[行为守则](https://gitee.com/openeuler/community/blob/master/code-of-conduct.md)。 +openEuler是一个开源社区。它完全依赖于社区提供友好的开发和协作环境，所以在参与社区贡献之前，请先阅读并遵守openEuler社区的[行为守则]()。 @@ -75,7 +74,7 @@ SIG就是Special Interest Group的缩写，openEuler社区按照不同的SIG来 - SIG组是开放的，欢迎任何人加入并参与贡献。 - SIG都是针对特定的一个或多个技术主题而成立的。SIG内的成员推动交付成果输出，并争取让交付成果成为openEuler社区发行的一部分。 -- SIG的核心成员主导SIG的治理。请查看[SIG的角色说明](https://gitee.com/openeuler/community/blob/master/community-membership_cn.md)。您可以在贡献的同时积累经验和提升影响力。 +- SIG的核心成员主导SIG的治理。请查看[SIG的角色说明]()。您可以在贡献的同时积累经验和提升影响力。 - 每一个SIG在Gitee上都会拥有一个或多个项目，这些项目会拥有一个或多个Repository。SIG的交付成果会保存在这些Repository内。 - 可以在SIG对应的Repository内提交Issue、针对特定问题参与讨论，提交和解决问题，参与评审等。 - 您也可以通过邮件列表、IRC或视频会议和SIG内的成员进行交流。 @@ -86,7 +85,7 @@ SIG就是Special Interest Group的缩写，openEuler社区按照不同的SIG来 找到您感兴趣的SIG组，可以帮助您在正确的地方提出问题，并得到更快的社区响应。 -- **方式一**：如果您不了解有哪些SIG或项目，您可以查看[SIG列表](https://openeuler.org/zh/sig.html)，它包含当前openEuler社区成立的所有SIG团队的清单。您可以通过该列表快速的定位到您感兴趣的领域所对应SIG团队。同时还会您提供该SIG团队的如下信息： +- **方式一**：如果您不了解有哪些SIG或项目，您可以查看[SIG列表]()，它包含当前openEuler社区成立的所有SIG团队的清单。您可以通过该列表快速的定位到您感兴趣的领域所对应SIG团队。同时还会您提供该SIG团队的如下信息： - SIG下的项目，以及项目的Repository地址 - SIG内的交流方式，包括邮件列表、IRC或视频会议等 @@ -104,7 +103,7 @@ SIG就是Special Interest Group的缩写，openEuler社区按照不同的SIG来 ### 给自己分配一个Issue -- **找到Issue列表**：在您感兴趣的项目的首页内（Gitee上的项目的Repository）的工具栏，点击“Issues”，您可以找到该SIG的Issue列表（如Community团队的Issue列表地址为https://gitee.com/openeuler/community/issues） +- **找到Issue列表**：在您感兴趣的项目的首页内（Gitee上的项目的Repository）的工具栏，点击“Issues”，您可以找到该SIG的Issue列表（如Community团队的Issue列表地址为） - **找到愿意处理的Issue**：如果您愿意处理其中的一个issue，可以将它分配给自己。只需要在评论框内输入 `/assign`或 `/assign @yourself`，机器人就会将问题分配给您，您的名字将显示在负责人列表里。 - **参与Issue内的讨论**：每个Issue下面可能已经有参与者们的交流和讨论，如果您感兴趣，也可以在评论框中发表自己的意见。 @@ -122,18 +121,18 @@ SIG就是Special Interest Group的缩写，openEuler社区按照不同的SIG来 #### 安装openEuler -请参考[下载安装openEuler](https://openeuler.org/zh/download.html)。 +请参考[下载安装openEuler]()。 #### 开发环境准备 -如果您想参与编码贡献，需要准备openEuler的开发环境，请参考[开发环境准备](https://gitee.com/openeuler/community/blob/master/zh/contributors/prepare-environment.md)。 +如果您想参与编码贡献，需要准备openEuler的开发环境，请参考[开发环境准备]()。 #### 下载和构建软件包 -如果您想下载、修改、构建及验证openEuler提供的软件包，请参考[构建软件包](https://gitee.com/openeuler/community/blob/master/zh/contributors/package-install.md)。 +如果您想下载、修改、构建及验证openEuler提供的软件包，请参考[构建软件包]()。 @@ -143,31 +142,31 @@ SIG就是Special Interest Group的缩写，openEuler社区按照不同的SIG来 每个SIG内的项目使用的编码语言、开发环境、编码约定等都可能存在差异的。如果您想了解并参与到编码类贡献，可以先找到该项目给开发者提供的贡献者指南——这个指南一般是在该SIG的首页地址内，以`CONTRIBUTING.md`文件的形式提供，或者就直接在该项目的`README.md`内（如何找到项目的Repository，请参考[找到您感兴趣的工作](#找到您感兴趣的工作)的内容）。 -除了这些文件外，SIG可能还会提供其他指南信息。这些信息位于SIG或其项目的特定社区目录中。如果您未找到相关信息，或者对相关信息有疑问，可以在该SIG内提交Issue，或者把问题或疑问发送到该项目所属SIG的邮件列表。如果您认为长时间没有得到回应，可以向community@openeuler.org求助。 +除了这些文件外，SIG可能还会提供其他指南信息。这些信息位于SIG或其项目的特定社区目录中。如果您未找到相关信息，或者对相关信息有疑问，可以在该SIG内提交Issue，或者把问题或疑问发送到该项目所属SIG的邮件列表。如果您认为长时间没有得到回应，可以向求助。 #### 下载代码和拉分支 -如果要参与代码贡献，您还需要了解如何在Gitee下载代码，通过PR合入代码等。openEuler使用过的是Gitee代码托管平台，向了解具体的指导，请参考[Gitee Workflow Guide](https://gitee.com/openeuler/community/blob/master/zh/contributors/Gitee-workflow.md)。该托管平台的使用方法类似GitHub，如果您以前使用GitHub，本章的内容您可以大致了解甚至跳过。 +如果要参与代码贡献，您还需要了解如何在Gitee下载代码，通过PR合入代码等。openEuler使用过的是Gitee代码托管平台，向了解具体的指导，请参考[Gitee Workflow Guide]()。该托管平台的使用方法类似GitHub，如果您以前使用GitHub，本章的内容您可以大致了解甚至跳过。 #### 修改、构建和本地验证 -在本地分支上完成修改后，进行构建和本地验证，请参考[构建软件包](https://gitee.com/openeuler/community/blob/master/zh/contributors/package-install.md)。 +在本地分支上完成修改后，进行构建和本地验证，请参考[构建软件包]()。 #### 提交一个Pull-Request -当你提交一个PR的时候，就意味您已经开始给社区贡献代码了。请参考[openEuler社区PR提交指导](https://gitee.com/openeuler/community/blob/master/zh/contributors/pull-request.md)。 +当你提交一个PR的时候，就意味您已经开始给社区贡献代码了。请参考[openEuler社区PR提交指导]()。 ### 检视代码 -openEuler是一个开放的社区，我们希望所有参与社区的人都能成为活跃的检视者。可以参考[社区成员](https://gitee.com/openeuler/community/blob/master/community-membership_cn.md)，该文档描述了不同贡献者的角色职责。 +openEuler是一个开放的社区，我们希望所有参与社区的人都能成为活跃的检视者。可以参考[社区成员]()，该文档描述了不同贡献者的角色职责。 **对于贡献者**，为了使您的提交更容易被接受，您需要： @@ -178,13 +177,13 @@ openEuler是一个开放的社区，我们希望所有参与社区的人都能 -**对于检视者**，强烈建议本着[行为准则](https://gitee.com/openeuler/community/blob/master/code-of-conduct.md)，超越自我，相互尊重和促进协作。在检视其他人的PR的时候，[补丁审核的柔和艺术](https://sage.thesharps.us/2014/09/01/the-gentle-art-of-patch-review/)提出了一系列检视的重点，旨在说明检视的活动也希望能够促进新的贡献者积极参与，而不会使贡献者一开始就被细微的错误淹没，所以检视的时候，可以重点关注包括： +**对于检视者**，强烈建议本着[行为准则]()，超越自我，相互尊重和促进协作。在检视其他人的PR的时候，[补丁审核的柔和艺术]()提出了一系列检视的重点，旨在说明检视的活动也希望能够促进新的贡献者积极参与，而不会使贡献者一开始就被细微的错误淹没，所以检视的时候，可以重点关注包括： + 贡献背后的想法是否合理 + 贡献的架构是否正确 + 贡献是否完善 -注意：如果您的PR请求没有引起足够的关注，可以在SIG的邮件列表或dev@openeuler.org求助。 +注意：如果您的PR请求没有引起足够的关注，可以在SIG的邮件列表或求助。 @@ -193,19 +192,19 @@ openEuler是一个开放的社区，我们希望所有参与社区的人都能 ### 选择社区组件打包 -您也可以参与社区组件打包，请参考[如何打包](https://gitee.com/openeuler/community/blob/master/zh/contributors/packaging.md)。 +您也可以参与社区组件打包，请参考[如何打包]()。 ### 参与非代码类贡献 -如果您的兴趣不在编写代码方面，可以在[非代码贡献指南](https://gitee.com/openeuler/community/blob/master/zh/contributors/non-code-contributions.md)中找到感兴趣的工作。 +如果您的兴趣不在编写代码方面，可以在[非代码贡献指南]()中找到感兴趣的工作。 ## 社区安全问题披露 -+ [安全处理流程](https://gitee.com/openeuler/community/blob/master/zh/security-committee/security-process.md)——简要描述了处理安全问题的过程。 -+ [安全披露信息](https://gitee.com/openeuler/community/blob/master/zh/security-committee/security-disclosure.md)——如果您希望报告安全漏洞，请参考此页面。 ++ [安全处理流程]()——简要描述了处理安全问题的过程。 ++ [安全披露信息]()——如果您希望报告安全漏洞，请参考此页面。 @@ -213,18 +212,11 @@ openEuler是一个开放的社区，我们希望所有参与社区的人都能 ### 社区内沟通方式说明 -openEuler社区的交流方式有邮件列表、IRC会议和视频会议等，使用方式请参考[社区交流方式指导](https://gitee.com/openeuler/community/tree/master/zh/communication)。 +openEuler社区的交流方式有邮件列表、IRC会议和视频会议等，使用方式请参考[社区交流方式指导]()。 -### 社区新闻和大事件 - -openEuler参加或举办的社区和技术交流会议，关于这些事件和其他社区事件信息均可以在[openEuler新闻](https://openeuler.org/zh/news.html)页面上找到。 - - - - -### 社区聚会 +### 社区活动 社区每年会定期举办开发者大会，您可以通过[https://openeuler.org](https://openeuler.org)上的信息或通过电子邮件与我们联系。来加入我们把~ @@ -232,4 +224,4 @@ openEuler参加或举办的社区和技术交流会议，关于这些事件和 # 问题反馈 -如果您在使用该贡献者指南或对开发过程有疑问，请随时告诉我们（community@openeuler.org），并在邮件标题内用“【开发过程疑问】”作为邮件标题写出你的疑问和困惑，openEuler社区运营团队会并尽力确保您的问题得到解答。 \ No newline at end of file +如果您在使用该贡献者指南或对开发过程有疑问，请随时告诉我们（），并在邮件标题内用“【开发过程疑问】”作为邮件标题写出你的疑问和困惑，openEuler社区运营团队会并尽力确保您的问题得到解答。 \ No newline at end of file