参与进来!
如果您有兴趣为 CakePHP 贡献力量并支持社区,我们非常欢迎您加入我们。有很多方法可以参与进来并提供帮助。
用户支持
为 CakePHP 做贡献的最棒方式之一,就是直接支持开发者社区。无需成为天才或专家即可参与进来,您可能恰好能解答一些正在被提出的问题。以下是一些入门方法:
教育与培训
帮助他人学习 CakePHP 也是为社区做出贡献的宝贵方式。您可以通过多种方式帮助他人,包括:
- 编码研讨会
- 现场工作坊
- 黑客马拉松
- 培训课程
- 教程
市场推广与宣传
作为一个开源项目,由 Cake 软件基金会 支持,我们没有大量的预算来推广和宣传框架,因此我们依赖像您这样的参与者来帮助支持社区。有很多行动可以帮助提高知名度,分享经验并教育您的开发人员同行了解 CakePHP。
撰写和讲述 CakePHP
积极地撰写和讲述 CakePHP 有助于传播有关该框架的信息。
- 撰写一篇关于某个特定功能或开发经验的文章或博客文章。
- 对文章或帖子进行评论,并提供想法和论点,以引发进一步的对话和反馈。
- 使用诸如 Facebook、Discourse 或 Twitter 等社交平台,提供指向文章、帖子、插件、活动等的链接。
帮助您的本地社区
我们依赖那些了解并理解其本地社区的人。这不仅指语言上的差异,还指当地的习俗和文化差异。您可以通过与您的本地社区联系并支持 CakePHP 来帮助我们。您可以采取的一些行动包括:
- 创建或加入本地用户组
- 组织活动或聚会
- 传播信息和意识
贡献代码
如果您想为错误修复贡献代码,请在问题的评论中协调您的方法,方法是链接到 gist/pastebin 或链接到修复的提交。
通过 Pull Request 贡献
通过在 GitHub 分支上提交提交来贡献是提交修复的首选方式。如果您的修复不止一个提交,则应将修复放在一个命名合适的分支上。这使得修复的集成更容易。
测试与质量保证
提交问题是开始为 CakePHP 做贡献的好方法。通过查找并报告代码中的问题,您可以通知维护者任何问题并帮助解决它们。所有 CakePHP 项目的问题都位于 GitHub 上
发现了一个错误?
有时 CakePHP 中会出现问题。如果您认为您遇到过一个,您可以:
- 搜索类似或 已存在的问题。
- 如果您确定它不存在,请创建一个 新问题,或者更新现有问题。
- 添加有关如何重现错误的详细说明。这可以是测试用例或演示问题的代码片段的形式。如果没有重现问题的方法,则意味着它不太可能得到修复。
需要额外信息的的问题
新问题 通常需要确认或需要更多信息。在不清楚的问题上请求更多信息不会花费太多时间,并且有助于加快流程。
确认或使需要重现方法的现有问题失效
如果一个问题不容易重现,或者不清楚,它将被设置为保留。处于保留状态的问题通常需要确认方法或需要更多信息。您可以通过查找重现问题的方法或敦促问题作者提供更多信息来提供帮助。处于保留状态的问题可以在这里找到 这里
维护版本中的 Bug 问题
现有版本通常有一些针对它们打开的问题。这些问题通常需要为其创建补丁和测试用例,以便可以解决它们。为打开的 未解决的问题 准备补丁是参与 CakePHP 的一个好方法,也是成为核心贡献者的第一步。
未来版本的特性和增强功能
我们目前正在开发 4.x 版本。仍有一些未完成的任务和 未解决的缺陷。如果某个问题已移至特定里程碑,则计划将其包含在该版本中。问题会根据社区反馈和核心团队的计划移至里程碑。如果您计划贡献功能,请同时包含该功能的相关测试用例。我们希望保持 CakePHP 尽可能无错误,并且测试用例已被证明对这一点有很大帮助。如果您提交的功能没有测试用例和文档,则极不可能被合并。
CakePHP 是 持续集成的,因此您可以随时在 Jenkins 服务器上检查 各种构建 的状态。
文档
文档是开始参与 CakePHP 的另一种绝佳方式。我们有两种主要形式的文档:API 和 Cookbook。API 是从源代码生成的,因此如果您发现 API 文档中的任何不准确之处或问题,您可以针对 源代码 提交补丁。Cookbook 是一个由社区管理的文档源,也可以在 GitHub 上找到。有关为文档做贡献的指南,请参阅 此处。
翻译
我们有来自世界各地的开发者使用 CakePHP。如果您不是英语使用者,将 Cookbook 内容翻译成您的语言是帮助支持社区的另一种方式。尽可能多地提供官方文档和支持材料,有助于降低使用该框架的门槛。
获取帮助
正在寻找帮助,但不知道在哪里找到它?以下是您可以找到社区驱动的支持和信息来源的所有位置
#Slack: 加入我们的 CakePHP Slack 频道
寻找工作或开发者
如果您正在寻找熟练的 CakePHP 开发人员,或者您自己是一名开发人员并正在寻找自由职业项目或公司职位,有很多资源可用
CakePHP 相关职位官方职业群体
面向自由职业开发人员的职位
CakePHP 相关职位发布
来自专家的开发和咨询
社区指南
以下是一些建议,旨在帮助保持 CakePHP 社区强大、活跃和健康,并成为一个让每个人都感到受欢迎的地方。这些绝不是规则或法律,而是建议和最佳实践。
- 请记住,当您谈论 CakePHP 时,您代表的是一个全球性的社区,其中大多数人对参与充满热情,并将其空闲时间和善意奉献给帮助框架。请友好和乐于助人,并始终以您期望从他人那里获得的方式尊重他人。
- 切勿基于个人意见或偏见,侮辱、嘲笑或奚落任何用户、用户组或社区。如果您不同意他们的意见或论点,只需陈述您的理由,提供示例或链接,并保持礼貌。如果他们的行为不当或使用辱骂性语言,请联系该频道的管理员将其移除。
- 切勿为了支持 CakePHP 而贬低、轻视、侮辱或以其他方式损害其他项目的名称或声誉。如果您想比较或宣传框架的功能,请始终以相关且专业的论点、积极的态度以及谦逊和尊重的方式进行。
- 切勿使用社区渠道发布或宣传商业服务或产品,或向其他用户发送与 CakePHP 或社区无关的内容。
- 在处理用户寻求帮助时,如果可能,请尝试解决他们的问题或疑虑,无论它看起来多么琐碎。我们都是从某个地方开始的。如果您没有时间、耐心或专业知识来回答,请始终将用户引导至 CakePHP 社区中心 https://community.cakephp.org
- 在讨论 CakePHP 的技术特性时,请始终尝试明确引用该特性在哪个版本的框架中可用。此外,如果可能,请尝试提供文档和示例,以帮助读者或听众更好地理解概念。请记住,在得出结论或维护错误论点之前,请始终核实您的事实。
- 在编写示例代码时,请始终尝试正确应用 CakePHP 约定和编码标准,并检查给出的示例是否不会引发错误或给出错误的结果。这促进了良好的实践,并帮助开发人员默认学习“正确的方法”,而无需遇到太多障碍。
- CakePHP 徽标和品牌资产的使用应遵循徽标使用指南中提供的说明:https://cakephp.com.cn/logos。遵循这些标准可确保框架的视觉识别从未被误传或滥用。
- 尝试正确使用 CakePHP 名称。名称应拼写为“CakePHP”,全部作为一个单词,使用大写“C”和“PHP”。这有助于保持框架的链接和引用的一致性。例如,CAKEPHP、Cakephp、cake-php 或仅 Cake 都是不正确的用法。维护名称的常用拼写和格式有助于保持品牌连贯和一致。
- 在营销或宣传环境中引用 CakePHP 时,有助于使名称脱颖而出或具有交互性。请考虑对 HTML 使用<strong>或<b>标签,对文档使用粗体格式,或将名称设为指向 https://cakephp.com.cn 的可见链接。请勿在任何正文中过度使用名称,而是尝试使任何直接使用名称都具有相关性。为了平衡使用,请尝试使用其他参考,例如“框架”或“项目”。
年度 CakePHP 大会
每年我们都会举办一次专门针对 CakePHP 的大会,举办现场研讨会并邀请各种优秀的演讲者,为您提供来自社区的最新最佳演示和演讲。
- 研讨会是学习 CakePHP 并及时了解最新版本和创新的绝佳方式,直接来自框架的核心开发人员!
- 大会期间将举办关于 CakePHP 和相关技术的演示、讨论和演讲,这是从社区学习更多知识的理想时机。
- 这是一个建立人脉、结识新老朋友并与项目核心成员一起享受乐趣的绝佳机会。此外,还有蛋糕!
有关会议和门票销售的更多信息,请访问 CakeFest 网站