diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 79a55a5..03565ec 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -43,29 +43,21 @@ export default defineConfig({ { text: '提案', items: [ - {text: '提案创作指南', link: '/guides/proposal'} + {text: '提案创作指南', link: '/guides/mentor'} ], }, { text: '孵化指南', items: [ - {text: '角色与职责', link: '/guides/roles_and_responsibilities'}, - {text: '贡献者', link: '/guides/committer'}, {text: '项目管理委员会', link: '/guides/ppmc'}, {text: '社区成熟建设指南', link: '/guides/community'}, ], }, - { - text: 'PMC指南', - items: [ - {text: '参与指南', link: '/guides/participation'}, - ], - }, {text: '常见问题解答', link: '/faq'}, ], footer: { - message: 'Licensed under the Apache License, Version 2.0.', - copyright: 'Copyright © 2024 The Dromara Software Foundation' + message: '', + copyright: 'Copyright © 2024 The dromara.org' }, socialLinks: [ { diff --git a/docs/faq.md b/docs/faq.md index 3f14ef3..69564ba 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -9,66 +9,20 @@ title: 常见问题解答 (FAQ) ### 1. 孵化流程 #### 1.1 项目X必须通过孵化器进入Dromara吗？ -是的。从DSF（Dromara Software Foundation）外部引入的代码只能通过孵化器进入DSF。孵化器负责以下工作： +是的。从dromara 开源组织外部引入的代码只能通过孵化器进入dromara 开源组织。孵化器负责以下工作： * 确认许可证符合要求； -* 确保版权许可已到位； * 要求所有初始开发者提交CLA（贡献者许可协议）。 +* 更改项目包名和包路径(org.dromara.xxx)。 +* 如果需要发布到MavenRepo，需要由IPMC批准。并且更改 groupId 为org.dromara。 -孵化器还为项目提供学习DSF工作方式的机会，由IPMC成员（导师）指导。 -#### 1.2 我是项目的导师，觉得自己可以完成所有工作。能否跳过孵化器？ -不能。孵化是一个正式的流程，旨在确保项目按规定被引入DSF，并为将来的IP问题提供记录。DSF不会允许任何项目跳过这个流程，因为这样可能会破坏监督的有效性。 - -#### 1.3 为什么项目XXX没有提到孵化器？该怎么迁移到Dromara的XXX项目下？ +#### 1.2 为什么项目XXX没有提到孵化器？该怎么迁移到Dromara的XXX项目下？ 孵化过程的职责划分如下： -1. 项目进入孵化器需要某个Dromara PMC（包括IPMC）作为发起人； +1. 项目进入孵化器需要某个Dromara TOC 成员（包括IPMC）作为发起人； 2. 一旦IPMC接管，指定的导师将负责监督项目的孵化进度； 3. 项目需每季度向IPMC提交进展报告，直到毕业为止； 4. 毕业后，如果是其他PMC发起的项目，它将转交给发起PMC，否则需董事会批准成立独立PMC。 要迁移到XXX项目，请先请求XXX PMC担任你的项目发起人，随后进入孵化流程。 -#### 1.4 如果有人提议将他们的代码捐赠给DSF的项目X，该怎么操作？ -孵化器只有在PMC投票通过接受代码时才会接纳代码： -1. 相关项目需在公共邮件列表上讨论此提议； -2. PMC投票决定是否赞助代码（或相关项目）； -3. 若同意，PMC应联系孵化器，并按照IP Clearance流程记录捐赠。 - -#### 1.5 捐赠的代码来自DSF外部，是不是完全归我们处置？ -并非如此。以下几点需注意： -* DSF中没有一个代码库可以独占某种通用技术； -* 初始代码库仅仅是“初始”，未来的代码和架构方向由社区决定； -* 任何感兴趣的贡献者都可以向DSF代码库贡献代码或提出相关项目。 - -### 2. 参与方式 - -#### 2.1 如何更新网站？ -请参考网站更新指南。如果你不是Incubator项目的提交者，可以通过提交补丁的方式参与。 - -#### 2.2 如何更新项目的孵化状态？ -查看维护Podlings摘要文件和项目状态页面的相关说明。 - -#### 2.3 为什么不使用问题跟踪系统记录孵化状态？ -问题跟踪系统无法满足法律归档和认证需求。而版本控制系统（如SVN）提供了身份验证功能，确保录入状态信息的人拥有权限。 - -#### 2.4 如何更新孵化项目的网站？ -阅读孵化政策，并参考网站指南。 - -#### 2.5 如何为基础设施站点获取Karma权限？ -向孵化器的通用邮件列表发送请求。 - -#### 2.6 如何搭建Podling网站？ -搭建网站需首先申请Karma权限。 - -#### 2.7 如何为现有Dromara提交者授予Karma权限？ -阅读权限授予指南。 - -#### 2.8 孵化器管理有哪些辅助工具？如何生成和维护这些工具？ -参阅孵化器管理工具设施。 - -### 3. 基础设施 - -#### 3.1 我们的项目如何申请资源？ -通过项目的开发邮件列表和PPMC协作处理。详细说明请参阅导师指南和基础设施说明。 -此FAQ旨在为参与Dromara孵化器项目提供清晰指导。如果有进一步的问题，请在邮件列表中提出。 \ No newline at end of file diff --git a/docs/guides/committer.md b/docs/guides/committer.md deleted file mode 100644 index 2d10f4d..0000000 --- a/docs/guides/committer.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -layout: home -footer: true -title: 贡献者 ---- - -# Dromara 开源社区 :: 贡献者 - -## 邮件列表 - -- **重要性：** 在 Dromara 社区中，一切事务需以异步方式进行，并存档于邮件列表中。常言道：“如果没在邮件列表中出现，那它就没发生过。” -- **原则：** 所有决策需在公共的邮件列表中进行，而非在 IRC、即时消息、Slack、私人邮件等非公开渠道。 -- **项目相关邮件列表：** - - **开发讨论列表（dev@project）：** 项目开发的主要讨论场所。 - - **用户列表（user@project 或 users@project）：** 供用户提问和讨论。 - - **问题列表（issues@project）：** 跟踪项目问题。 - - **提交列表（commits@project）：** 记录代码提交。 -- **社区相关邮件列表：** - - **community：** 供所有社区贡献者讨论 Dromara 相关事项。 - - **infrastructure：** 基础设施团队讨论和处理社区基础设施需求。 - - **legal-discuss：** 法律相关问题讨论。 - - **builds：** 持续集成相关的讨论。 -- **行动项：** - - 熟悉开发者的邮件交流技巧。 - - 订阅项目的用户、开发、问题及提交邮件列表。 - - 关注孵化器的动态，订阅孵化器的通用列表。 - - 订阅 Dromara 社区的基础设施和法律讨论列表。 - -### 私密邮件列表 -- **使用场景：** - - 项目通常有一个私密邮件列表（如 private@project.dromara.org），用于处理敏感讨论。 - - **注意事项：** - - 避免在同一邮件中混用公共和私密邮件列表。 - - 一般仅需发至开发列表，因为 PMC 成员也会订阅该列表。 - -## 项目网站 - -- **资源：** 参考 [孵化项目网站文档](http://www.dromara.org/dev/)。 -- **注意事项：** - - 学习如何搭建和维护项目网站。 - -## 贡献者资源 - -- **指南：** 查看 [新贡献者指南](http://www.dromara.org/dev/) 以获取帮助。 -- **行动项：** - - 经常浏览 Dromara 官方开发页面，了解最新资讯。 - - 订阅基础设施列表，关注幕后支持工作。 - - 主动响应项目基础设施相关问题，例如网站或代码仓库服务是否正常。 - -## Podling PMC (PPMC) - -- **职责：** - - 熟悉 Dromara 社区的孵化政策。 - - 参阅 [PPMC 指南](http://www.dromara.org/dev/)。 - -## 为新贡献者提供引导 - -- **目标：** 通过导师或社区成员引导新贡献者了解社区文化。 -- **原则：** - - 尽量在公开的论坛或邮件列表中进行讨论，除非涉及敏感问题。 - - 私密讨论仅限安全或个人问题。 -- **导师职责：** - - 帮助贡献者逐步适应公开讨论的习惯。 - - 避免私密邮件列表的过度使用。 - - 鼓励贡献者优先在项目公共列表中提问。 - -## 提问与支持 - -- **问题渠道：** 在孵化器的通用邮件列表中提问。 -- **参考资源：** 查看 [开发者信息](http://www.dromara.org/dev/) 获取更多帮助。 - -以上内容为 Dromara 开源社区贡献者的职责及相关资源指引，为新加入的成员提供清晰的参与路径。 \ No newline at end of file diff --git a/docs/guides/community.md b/docs/guides/community.md index 8510031..dcfae50 100644 --- a/docs/guides/community.md +++ b/docs/guides/community.md @@ -4,28 +4,19 @@ footer: true title: 社区成熟建设指南 --- -# Dromara 开源社区 :: 社区成熟建设指南 +# 社区成熟建设指南 ## 摘要 本文旨在帮助每个项目团队理解构建开放和多样化社区的重要性。提供了接纳新贡献者、核心成员的指导，以及如何让更多人参与社区建设的建议。 ## 什么是开放和多样化的社区？ -Dromara 社区的目标是构建一个开放、多样化、基于贡献价值的社区。这样的社区比封闭的社区更具活力和生产力。 +Dromara开源组织的目标是构建一个开放、多样化、基于贡献价值的社区。这样的社区比封闭的社区更具活力和生产力。 ## 人员 随着项目的发展，接纳新贡献者是社区自我更新的必要方式。项目需要探索如何吸引新的开发者和贡献者加入社区。接纳新贡献者有助于提升社区的多样性和项目的长期发展。虽然社区建设需要耗费精力，但这是对项目未来的必要投资。 社区的开放性不仅体现在贡献者数量上，还包括在交流中保持尊重和开放。社区成员需要学会通过有效的沟通来解决技术分歧，同时维护良好的人际关系。 -## 沟通 -邮件列表是 Dromara 社区交流的核心渠道，也是项目的公共和历史记录。其他形式的沟通（如点对点、即时消息、线下会议等）仅作为补充。尽量避免因为非公开沟通导致部分成员被排除在外。 - -Dromara 社区的邮件列表是公开的、可归档的，任何人都可以实时或通过历史记录了解项目进展。公开表达意见不仅有助于透明，也能维护社区成员的信誉。 - -**私下沟通**虽然有时更直接，但可能引发分歧，削弱社区的凝聚力。因此，重大事项需回归到公开渠道进行讨论。 - -如果项目使用其他形式的沟通，应确保重要内容归档并回归邮件列表。还需定期提醒社区成员其他沟通方式的存在。 - ## 社区建设 在项目正式成为社区重点项目之前，需构建一个多样化且可持续的社区。这需要时间、努力和一些巧妙的方法。社区建设可能需要开发者暂时减少编码工作，将更多时间投入到社区建设上。 @@ -41,16 +32,5 @@ Dromara 社区的邮件列表是公开的、可归档的，任何人都可以实 - 提交会议演讲 - 撰写博客和技术文章 -## 激励用户转变为开发者 -如果项目用户众多，但活跃开发者较少，可以采取措施鼓励用户参与开发： -- 鼓励有经验的用户回答问题，甚至故意留出时间让用户提供答案。 -- 对于用户提出的好建议，邀请他们提交补丁或参与实现。 -- 对用户回答的正确内容表示认可，帮助他们建立信心。 - -## 帮助开发者成为贡献者 -如果开发者活跃度高但难以长期参与，可能是社区的接纳流程需要优化。对贡献进行及时的反馈和认可非常重要。例如： -- 迅速审查并处理补丁或拉取请求。 -- 在提交信息和关闭问题时给予贡献者明确的署名。 -- 鼓励开发者参与新的任务并引导其深入社区。 通过这些实践，Dromara 开源社区可以构建一个充满活力和包容性的社区，为项目的长期发展提供坚实的基础。 \ No newline at end of file diff --git a/docs/guides/mentor.md b/docs/guides/mentor.md new file mode 100644 index 0000000..37b1b41 --- /dev/null +++ b/docs/guides/mentor.md @@ -0,0 +1,6 @@ +--- +layout: home +footer: true +title: 导师列表 +--- +# 导师列表 diff --git a/docs/guides/participation.md b/docs/guides/participation.md deleted file mode 100644 index a12d049..0000000 --- a/docs/guides/participation.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -layout: home -footer: true -title: 参与指南 ---- -# Dromara 开源社区 :: 参与指南 - -## 一般网络礼仪 - * 请确保了解Dromara邮件列表的使用方式，可参考邮件列表指南。 - * 配置邮件客户端以发送纯文本邮件，不附带附件。HTML邮件可能会被Dromara的垃圾邮件过滤器拒收。 - * 孵化器是一个公共且多元化的社区，建立良好的社交关系和声誉至关重要。请保持礼貌、友好和外交技巧。 - -## 参与方式 - -### 在通用邮件列表上 -* general@incubator.dromara.org是公开的邮件列表，任何人都可以订阅、阅读和发表意见。 -* 虽然任何人都可以参与讨论和投票，但只有孵化器PMC成员的投票具有约束力。 - -### 作为用户 -* 用户是指使用软件的人。大多数Dromara项目拥有活跃的用户社区，可以提供帮助，但孵化项目可能例外。 -* 对于不成熟的项目（如许多孵化项目），建议采取主动态度。阅读参与开源的指南以获得更多帮助，并尝试成为开发者。 - -### 作为开发者 -* 开发者是指任何积极参与项目开发的人，不仅包括编码者和文档编写者，还包括邮件列表讨论者和用户问题解答者。 -* Dromara是一个“行动至上”的社区（DO-ocracy）。成为开发者是成为提交者的第一步。建议阅读Dromara运作方式及开发者文档。 - -### 作为提交者 -* 提交者拥有源码库的写入权限。孵化项目中提交者的选举方式与其他Dromara项目略有不同。 -* 如果你有兴趣成为提交者，可以： - 1. 在提案中被列为初始提交者。 - 2. 在开发列表中主动参与开发工作，展示贡献能力。这种方式比仅在提案中添加名字更能帮助项目。 - -### 作为导师 -* 任何熟悉开源或Dromara的人都可以非正式地指导孵化项目，通过订阅和参与开发讨论提供帮助。 -* 正式导师资格仅限于IPMC成员和ASF成员。如果有意担任正式导师，可通过general@incubator.dromara.org自我介绍并表示意愿。 - -### 加入孵化器PMC -* 鼓励Dromara成员加入孵化器PMC，方法是向PMC私有邮件列表发送请求。 -* 非成员也可通过标准Dromara方式选举加入，这些选举在PMC私有邮件列表中进行。 - -参与孵化器是一个学习和贡献的过程，无论作为用户、开发者还是导师，每个人都能通过行动为社区创造价值。 \ No newline at end of file diff --git a/docs/guides/ppmc.md b/docs/guides/ppmc.md index c51e27f..5b724e6 100644 --- a/docs/guides/ppmc.md +++ b/docs/guides/ppmc.md @@ -4,100 +4,32 @@ footer: true title: 项目管理委员会 --- -# Dromara 开源社区 :: 项目管理委员会（PPMC）指南 +# 项目管理委员会（PPMC）指南 ## PPMC 角色与职责 -PPMC 的主要职责是帮助项目孵化团队（Podling）学会自我治理。PPMC 的运作方式类似于 PMC，但它向孵化器 PMC（IPMC）报告，而非直接向 ASF 董事会报告。 +PPMC 的主要职责是帮助孵化项目学会自我治理。让项目更好的发展，为社区贡献者提供指导。 ### PPMC 的构成 - **初始成员：** 由项目导师和初始贡献者组成。 - **职责：** - 监督孵化项目。 - - 决定是否新增 PPMC 成员。 - -## 私密邮件列表 - -- **私密邮件地址：** `private@project`，用于讨论机密主题。 -- **使用注意：** - - 避免将私人和公开邮件列表混合使用。 - - 多数讨论应在开发邮件列表（`dev@project`）中进行。 - - 私密列表仅用于讨论不适合公开的问题，如新增贡献者或 PPMC 成员资格的适宜性。 - -### 验证订阅情况 -- 使用 [Whimsy Podling Roster]() 检查订阅情况。 -- 可发送测试邮件验证成员是否已订阅。 + - 项目发布、和升级。 + - 提名新的 PPMC，Committer 成员 ## 项目状态报告 - **提交频率：** - - 初创项目每月报告一次，三个月后改为每季度一次。 + - 初创项目每月报告一次。 - **报告内容：** - - 孵化器 PMC 或 ASF 董事会需关注的事项。 - - 是否存在法律、基础设施或跨项目问题。 - 孵化过程中的障碍。 - 上次报告以来的进展。 - 下阶段计划。 - - 导师活跃度等。 - **撰写指南：** - 在开发邮件列表中讨论并协作完成报告。 - 使用最新模板，避免更改主题格式。 - **导师签署：** - - 导师必须签署报告，否则报告将不被接收。 - -### 提交报告步骤 -1. 在孵化器的 [Wiki 页面]() 添加报告。 -2. 遵循提醒邮件中的指示，使用指定模板提交至 `` 页面。 - -## 项目状态页面 - -- 每个孵化项目在孵化器网站上有一个状态页面，记录其状态。 -- 参考 [孵化器网站指南]() 了解如何更新。 - -## 新增贡献者和 PPMC 成员 - -### 新增贡献者 - -- **标准：** - - 各孵化项目可根据自身情况决定新增贡献者的标准。 - - 通常保持较低门槛，以鼓励更多参与。 -- **流程：** - 1. 在私密邮件列表中发起 `[DISCUSS]` 和 `[VOTE]` 线程。 - 2. 投票通过后，向提名者发出邀请。 - 3. 导师按照流程完成新增贡献者的操作。 - 4. 引导新贡献者参考 [Dromara 开发者页面]() 和相关指南。 - -### 新增 PPMC 成员 - -- **目标：** 鼓励所有贡献者成为 PPMC 成员，关注其社区参与表现。 -- **流程：** - 1. 在私密邮件列表中发起 `[DISCUSS]` 讨论线程。 - 2. 一致同意后，发起 `[VOTE]` 线程。 - 3. 投票通过后，由 PPMC 成员发送 `[VOTE][RESULT]` 邮件通知 IPMC。 - 4. 正式邀请新成员，并指导其订阅相关邮件列表。 - -## 导师管理 - -### 新增导师 - -- **资格：** 导师需为 IPMC 成员。 -- **流程：** - - IPMC 成员可主动提出加入导师团队。 - - PPMC 决定是否接受新的导师。 - - 在 [Whimsy]() 中更新导师信息。 - -### 移除导师 - -- 如果导师无法履职或长期未参与，可由其他导师在 Whimsy 上将其移除。 - -## PPMC 的决策与投票 - -- **投票权：** - - PPMC 成员的投票仅在新增成员和贡献者时具有约束力。 - - 发布投票仅限 IPMC 成员具有约束力。 -- **注意事项：** - - 投票的约束力与邮件列表无关。 - - 使用正式流程并记录所有投票结果。 + - 导师必须查看、审核和签署报告，并且提交给 TOC 委员会。 以上指南旨在帮助 Dromara 开源社区的 PPMC 成员有效地管理项目，并为社区的长期健康发展奠定基础。 \ No newline at end of file diff --git a/docs/guides/proposal.md b/docs/guides/proposal.md deleted file mode 100644 index dc042c3..0000000 --- a/docs/guides/proposal.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -layout: home -footer: true -title: 提案创作指南 ---- -# Dromara 开源社区 :: 提案创建指南 - -## 概述 - -本指南介绍了提交提案到Dromara孵化器的流程和方法。指南内容来自社区的共识，是一种参考建议，并非硬性标准。根据项目的实际情况，可以对提案模板进行适当修改。 - -### 背景 - -进入孵化器的过程通过投票决定，而提案是发起投票的基础文件。良好的提案能显著提升通过率。 - -提案会引发社区关注。Dromara社区邮件列表是一个公开透明的讨论平台，提案应面向更广泛的受众，而不仅限于IPMC成员。利用这一机会吸引潜在开发者和用户十分重要。 - -好的提案不仅描述当前项目的细节，还应展望未来的项目发展方向。同时，我们理解项目会随着时间推移不断演化。 - -### 持续改进 - -孵化流程会不断演化，旨在帮助新项目比现有项目更强大、更成功。因此，之前孵化项目的经验可能不是完全可靠的指导。此外，一些文档可能存在滞后。 - -### 寻求帮助 - -如需改进本指南，可通过以下方式贡献： -* 在社区Issue平台提交补丁； -* 向社区邮件列表发送建议； -* 提交Pull Request到孵化器的代码库。 - -## 制定提案 - -### 准备工作 -1. 学习资料：从社区的《孵化器指南》和相关文档开始学习。 -2. 邮件订阅：订阅孵化器邮件列表，查阅过去的邮件记录，了解讨论和决策的形式。 -3. 寻找导师：联系一位熟悉Dromara社区流程的导师（Champion），帮助指导提案撰写和流程推进。 -4. 研究提案案例：阅读近期提案，了解哪些项目成功成为正式项目，哪些未能通过，以及常见的孵化问题。 -5. 社区协作：与项目团队讨论未来目标和选择加入Dromara的理由。通过邮件列表提出问题，获取反馈。 - -每个提案都有独特之处，模板仅作参考。项目团队可根据需要调整内容结构。 - -### 项目命名 - -在孵化前确定合适的项目名称和产品名称。虽然孵化期间可以更改名称，但变更可能会对社区造成一定干扰，因此建议尽早决定。 - -### 提案展示 - -完成提案初稿后，将提案内容以纯文本形式发送至孵化器邮件列表，邮件主题应以[PROPOSAL]开头，并明确表示希望讨论该提案。 - -若提案引起兴趣，讨论会随之展开。多数提案需要在讨论中进一步完善，以获得孵化器最大的支持。 - -### 提案的完善 - -展示提案后，需要根据反馈在邮件列表中不断完善内容。这是与孵化器交流和改进提案的重要机会。 - -可考虑使用Wiki页面来协作编辑提案，并邀请感兴趣的人士订阅页面更新通知。但注意，Wiki仅作为内容开发工具，讨论应在邮件列表中进行。 - -有效管理这一过程有助于团队建设和社区协作。 - -### 提案投票 - -当提案达成共识后，可发起投票流程： -1. 确保提案内容最终版本已定，若在Wiki上开发提案，需标注“开发完成”并设置页面只读。 -2. 将最终提案内容嵌入邮件或附上Wiki页面的版本号，发送至邮件列表发起投票。 - -若提案内容在投票期间需要修改，则需取消当前投票，修改提案后重新发起投票。 - -## 提案模板 - -模板旨在教育和启发项目团队撰写提案。每个项目提案都是独一无二的，团队可根据实际情况增减或调整内容。 - -使用模板时，请删除注释和示例部分，仅保留最终提案文本。模板的具体格式远不如提案的实际内容重要。 - -通过以上流程和指南，Dromara开源社区希望帮助项目团队顺利完成孵化提案，迈向正式项目的成功道路。 \ No newline at end of file diff --git a/docs/guides/roles_and_responsibilities.md b/docs/guides/roles_and_responsibilities.md deleted file mode 100644 index 1117a78..0000000 --- a/docs/guides/roles_and_responsibilities.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -layout: home -footer: true -title: 角色与职责 ---- - -# Dromara 开源社区 :: 角色与职责 - -## 理事会 - -- **角色：** 负责管理 Dromara 社区的组织事务。 -- **职责：** - - 理事由社区成员选举产生。 - - 理事会将孵化事务的管理责任委托给孵化项目管理委员会（Incubator PMC）。 -- **与孵化的关系：** - 理事会成员可能会积极参与孵化工作，但其发言通常代表个人观点，非理事会政策，除非另行说明。 - -## 孵化项目管理委员会（PMC） - -- **角色：** 监督和支持项目在孵化过程中发展。 -- **职责：** - - 审核并接受候选项目进入孵化流程。 - - 指导孵化项目遵循 Dromara 社区的开发哲学和协作原则。 - - 维护孵化历史记录和信息存储。 - - 协助导师履行职责。 - - 定期评估孵化项目状态并建议其： - - 毕业成为正式项目； - - 继续接受孵化支持； - - 或者终止孵化。 -- **其他：** - - 孵化项目需定期向 PMC 报告，以帮助 PMC 了解项目状态。 - - PMC 成员具备孵化过程的专业知识，可在孵化过程中为项目或导师提供支持。 - - 成员可通过投票加入 PMC，Dromara 社区成员可以申请加入。 - -## 孵化 PMC 主席 - -- **角色：** 理事会任命的人员，主要负责孵化 PMC 的政策监督和执行。 - -## 候选项目 - -- **定义：** 候选项目是申请孵化的项目。 -- **要求：** - - 项目需有一名“引荐人”（Champion）。 - - 候选项目可以： - - 指定现有 Dromara 项目为赞助方； - - 明确孵化期间的特殊需求； - - 总结与现有或计划项目的关系。 -- **孵化流程：** - - 引荐人提议候选项目进入孵化。 - - 赞助方批准后，PMC 将项目列为孵化项目并分配导师。 - -## 引荐人（Champion） - -- **角色：** Dromara 社区成员或负责人，支持候选项目申请孵化。 -- **职责：** - - 在孵化前： - - 帮助项目克服流程相关障碍； - - 指出可能影响毕业或孵化的潜在问题； - - 寻找适合的导师并引导项目进入孵化。 - - 在孵化后，引荐人角色可结束，也可继续担任导师。 - -## 赞助方 - -- **角色：** 判断候选项目是否符合 Dromara 社区目标，并支持其完成孵化。 -- **类型：** - - Dromara 社区内的现有项目。 - - 孵化 PMC。 -- **职责：** - - 提供候选项目的初始审批。 - - 提名导师并协助孵化。 -- **其他：** - - 赞助方通过导师在孵化过程中正式代表其立场。 - -## 导师（Mentor） - -- **角色：** 由赞助方指派，指导孵化项目并确保其遵循社区原则。 -- **职责：** - - **对孵化项目：** - - 确保 PMC 决议及时执行； - - 协调孵化项目与社区间的沟通； - - 协助解决基础设施支持、授权问题等事务。 - - **对 PMC：** - - 监控孵化项目的进展； - - 评估项目是否符合孵化要求； - - 提交关于项目状态的报告。 - - **对赞助方：** - - 向赞助方汇报孵化项目的进展。 - -## 提交者（Committer） - -- **角色：** 负责代码提交及项目发展。 -- **要求：** - - 保持与导师的沟通，确保孵化相关事务透明。 - - 积极吸纳新的提交者。 - - 确保决策过程公开可审计。 - - 遵守 Dromara 社区的政策和流程。 -- **目标：** 展现社区协作精神，制定符合 Dromara 实践的贡献者引入文档。 - -此描述体现了 Dromara 开源社区孵化流程中各角色的责任与协作方式，为新成员参与提供清晰指引。 \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index adc896f..f055783 100644 --- a/docs/index.md +++ b/docs/index.md @@ -3,37 +3,44 @@ layout: home footer: true title: 孵化器 --- -# Dromara 开源社区 :: 孵化器 +# 孵化器 -### 关于孵化器 +## 关于孵化器 -Dromara开源社区孵化器为有意加入Dromara开源社区的项目提供服务。 +Dromara开源组织孵化器为有意加入Dromara开源组织的项目提供服务。 孵化器帮助这些新加入的项目（称为“孵化项目”）逐步适应Dromara社区的治理模式和运作方式，同时引导它们使用社区提供的资源，最终成长为Dromara的正式项目。 -孵化器会为每个孵化项目分配多位导师，协助它们与Dromara社区的各个团队（例如孵化器管理团队、基础设施团队等）进行沟通，推动项目的成长和顺利运作。 - -### 孵化器的历史 - -Dromara孵化器创立以来，已帮助众多项目成功孵化。在此过程中，社区导师通过丰富的经验与支持，指导孵化项目完成从入门到成熟的整个流程。目前，孵化器通常会同时接收若干个孵化项目，每个项目的孵化周期通常为1至2年。 ### 孵化器指南 孵化器为潜在的孵化项目提供详细的指南，帮助它们评估Dromara开源社区是否适合自身发展，并指引其完成成为孵化项目的必要步骤。 -### 孵化器分享 +### 前置条件 + +* 项目必须是原创且不能是 Fork 版本。 +* 项目必须是完整的应用解决方案。 +* 项目必须有良好的代码注释和不断完善的使用文档。 +* 项目至少在近 2 个月内有实际有效的代码提交记录。 + + +### 寻找导师 -多年来，Dromara社区的孵化器在各类会议中分享了许多经验和案例，例如： -* Dromara之道：介绍社区的运作模式与价值观。 -* 孵化项目的发布指导：为孵化项目提供详细的发布流程与注意事项。 -* 如何成功毕业：帮助孵化项目了解如何成长为正式项目。 +您需要寻找导师，以了解如何成为孵化项目，可以在导师列表中寻找你需要的导师。 -这些分享体现了Dromara孵化器对开源项目成长的支持与承诺。 +每个至少要有一个导师。推荐 每个项目有 3 位导师。 -### 关于Dromara开源社区 +### 编写提案 -Dromara开源社区为广泛的开源项目提供组织支持、法律保障和资源协助。 +您需要和导师一起编写提案内容。以便通过 Dromara TOC 委员会的评审通过。 -社区通过“Dromara之道”的协作与贡献模式，推出高质量、企业级的免费开源软件，吸引了大量用户和开发者参与。社区采用兼容性强且对商业友好的开源协议，方便个人和企业使用。 +提案内容应该包含以下内容： -了解更多Dromara社区的整体情况，或者通过社区发展项目与我们联系，探讨相关问题！ \ No newline at end of file +``` +项目名称 +描述 +社区参与度 +代码地址 +人员 +license +``` \ No newline at end of file diff --git a/docs/policy/incubation.md b/docs/policy/incubation.md index cd40e33..071f24a 100644 --- a/docs/policy/incubation.md +++ b/docs/policy/incubation.md @@ -3,80 +3,8 @@ layout: home footer: true title: 孵化政策 --- -# Dromara 开源社区 :: 孵化政策 +# 孵化政策 ## 关于本文件 -本文件为Dromara开源社区孵化器PMC制定的孵化流程政策和指南的参考文档。 - -文档中使用的术语如“MUST”、“SHALL”等符合RFC 2119的定义，用于描述相关规定的强制性和推荐性要求。我们还提供了更具操作性的《孵化器指南》，便于潜在项目更好地理解孵化流程。 - -## 范围 - -本文件定义了孵化期间孵化项目必须满足的最低要求和流程，仅适用于孵化过程。 - -## 与其他文件的关系 - -本文件是孵化政策的权威文件。当其他文件的内容与本文件冲突时，以本文件为准。 - -## 修改本文件 - -对本文件内容的任何修改必须由孵化器PMC批准。 - -## 孵化项目报告 - -每个处于孵化中的项目必须定期向孵化器PMC报告： -• 孵化初期的前三个月每月报告一次； -• 之后每季度报告一次； -• 孵化器PMC可根据需要要求更频繁的报告。 - -报告应详细说明孵化项目的整体进展及遇到的问题。 - -## 孵化项目约束 - -### 网站 - -孵化项目在网站托管和品牌使用方面存在限制。具体要求请参考《孵化项目网站指南》。 - -### 品牌 - -孵化项目对自身及Dromara社区品牌的使用有一定限制。详细信息请参考《孵化项目品牌指南》。 - -### 宣传 - -孵化项目在宣传活动（如新闻稿）的发布上存在限制。请参考《孵化项目宣传指南》。 - -## 免责声明 - -孵化项目必须在其网站、文档、发布版本及发布公告中包含明确的免责声明。 - -### 标准免责声明 - -如果孵化项目遵循所有社区政策，可使用以下标准免责声明： - -Dromara孵化项目[项目名称]正在孵化中，由Dromara社区支持孵化。孵化状态表明该项目尚未完全被社区正式认可，但不一定反映代码的完整性或稳定性。 - -### 工作进展免责声明 - -如果孵化项目的发布版本可能未完全遵循社区政策，可使用工作进展免责声明，同时明确存在的已知问题列表。 - -## 发布 - -孵化项目不得在未经孵化器PMC批准的情况下发布Dromara正式版本。发布流程包括： -1. 在开发邮件列表中进行投票，获得至少三位+1票； -2. 将投票结果提交孵化器PMC批准； -3. 批准后，发布版本文件中需包含免责声明，且文件名需标明“incubating”字样。 - -## 增加PPMC成员 - -在PPMC内部投票通过新成员后，需向孵化器PMC发送通知邮件，之后才能正式邀请新成员加入PPMC。 - -## 加入IPMC - -IPMC新成员需在IPMC内部完成投票，投票通过后通知董事会，并正式邀请新成员加入。 - -## 终止 - -孵化器PMC应通知违反政策的孵化项目，并允许其纠正。如未能改正，孵化器PMC可考虑终止该项目的孵化状态。 - -以上政策确保孵化项目在Dromara开源社区中规范发展，顺利成长为正式社区项目。 \ No newline at end of file +本文件为Dromara开源社区孵化器制定的孵化流程政策和指南的参考文档。