Skip to content

Commit bd12ac6

Browse files
committed
Added 'src/developer_guide.md'.
1 parent 9138db6 commit bd12ac6

File tree

3 files changed

+66
-5
lines changed

3 files changed

+66
-5
lines changed

src/SUMMARY.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -153,14 +153,18 @@
153153
- [入门](community_guide/getting_started.md)
154154
- [贡献者路径](community_guide/path.md)
155155

156-
---
157156

158-
# 开发者指南
157+
- Ansible 专辑贡献者指南(略)
158+
- `ansible-core` 贡献者指南(略)
159+
- 高级贡献者指南(略)
160+
- Ansible 文档风格指南(略)
161+
162+
163+
---
159164

160-
- [关于开发者指南](dev_guide.md)
161-
- [本地开发](dev_guide/developing_locally.md)
162-
- [插件开发](dev_guide/plugins.md)
165+
# 扩展 Ansible
163166

167+
- [开发者指南](./developer_guide.md)
164168

165169
---
166170

src/community_guide/path.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,4 +76,47 @@
7676
我们不期望每个人都无所不知。要从小事做起,从大处着眼。当咱们经常做出贡献时,咱们在相关领域的熟练程度和判断力会迅速提高,同时咱们在项目中的重要性也会随之提高。
7777

7878

79+
请参阅 [与 Ansible 社区交流](getting_started.md#与-ansible-社区交流),了解与 Ansible 社区交流和互动的方式,包括工作组会议、访问 Bullhorn 新闻公告和即将举行的贡献者峰会。
80+
81+
82+
## 教会其他人
83+
84+
通过 [改进文档](https://docs.ansible.com/ansible/latest/community/documentation_contributions.html#community-documentation-contributions)、在 [Matrix/Libera.Chat IRC](getting_started.md#与-ansible-社区交流) 上回答其他贡献者和用户的问题、就问题和拉取请求提供建议,以及在 [论坛](https://docs.ansible.com/ansible/latest/community/communication.html#ansible-forum) 上参与话题讨论等,与其他贡献者分享咱们的经验。
85+
86+
87+
## 成为某个专辑的维护者
88+
89+
90+
如果咱们是某个专辑的代码贡献者,咱们就可以获得该代码仓库中的扩展权限,而成为一名维护者。专辑维护者是社区信任的贡献者,他们定期为项目做出重要贡献,并显示出自己是相关领域的专家。有关详细信息,请参阅 [专辑维护者指南](https://docs.ansible.com/ansible/latest/community/maintainers.html#maintainers)
91+
92+
93+
对于某些用到 [专辑机器人](https://github.com/ansible-community/collection_bot) 的专辑,比如 [community.general](https://github.com/ansible-collections/community.general)[community.network](https://github.com/ansible-collections/community.network),咱们可以拥有不同级别的访问权限。
94+
95+
96+
- [模组维护者](https://docs.ansible.com/ansible/latest/community/maintainers_workflow.html#module-maintainers) - 成为专辑维护者之前的阶段。该文件通常是个模组或插件。文件维护者拥有间接提交权;
97+
- `supershipit` 权限 - 与某个文件的维护者类似,但维护者间接提交的范围是整个代码仓库;
98+
- `triage` 权限 - 允许贡献者管理 issues 和拉取请求的该代码仓库权限;
99+
- `write` 权限 - 又称为例 `commit` 的该代码仓库权限。换句话说,就是成为一名提交者。此访问级别允许贡献者合并拉取请求到 `development` 分支,以及执行 [专辑维护者指南](https://docs.ansible.com/ansible/latest/community/maintainers.html#maintainers) 中列出的所有其他活动。
100+
101+
有关权限级别的信息,请参阅 [GitHub 官方文档](https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization)
102+
103+
104+
## 成为指导委员会成员
105+
106+
107+
> **注意**:要成为一名指导委员会成员,咱们不必是程序员。
108+
109+
110+
[指导委员会](https://docs.ansible.com/ansible/latest/community/steering/steering_index.html#community-steering-committee) 的成员身份,体现了最高级别的信任,允许贡献者通过为 Ansible 项目做出重要决策,领导这个项目。委员会成员是社区的领导者,他们决定着项目的未来和整个 IT 领域自动化的未来。
111+
112+
113+
就像现任委员会成员在获得该地位之前所做的那样,要达到该地位,并完成这个文档中提到的事项,咱们应该:
114+
115+
- 订阅、评论 *community topics<creating_community_topic>* 和其上投票;
116+
- 提出咱们的主题;
117+
- 若时间允许,要参加 [社区的会议](https://github.com/ansible-community/meetings/blob/main/README.md#schedule)。请注意,这 **不是** 一项要求。
118+
119+
120+
(End)
121+
79122

src/developer_guide.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# 开发者指南
2+
3+
4+
{{#include inventories_building.md:3:7}}
5+
6+
7+
欢迎来到 Ansible 开发者指南!
8+
9+
10+
如果咱们打算通过在本地使用某个定制模组或插件、创建某个模组或插件、为现有模组添加功能,或扩大测试覆盖范围来扩展 Ansible,本指南就是为咱们准备的。我们为开发者提供了如何测试模组和为模组编写文档的详细信息,以及将模组或插件纳入 Ansible 主代码仓库的先决条件。
11+
12+
13+
14+

0 commit comments

Comments
 (0)