新功能请求¶
NFR 是一份简短的文档,解释了如何提交新功能请求、如何实现该功能,以及如何帮助核心开发人员和其他人理解和实现它。
NFR 包含:
- 建议的语法
- 建议的类名和方法
- 详细描述其用法
- 它如何使框架和社区受益
- 如果该功能已在其他框架中实现,则需简要说明其实现方式及其优势
在以下情况下,新功能请求将被拒绝如果:
- 该功能使框架变慢
- 该功能没有为框架提供任何附加价值
- NFR 不清晰,文档不佳,解释不清楚等
- NFR 未与团队讨论或未由社区投票
- NFR 未遵循框架当前的指南/哲学
- NFR 影响/破坏了在当前/旧版本框架中开发的应用程序
- 原始发布者在被要求时未提供反馈/输入
- 技术上无法实现
- 它只能用于开发/测试阶段
- 提交/提议的类/组件不遵循单一职责原则
- 使用静态方法 - (不允许)
发送 NFR 时,您无需提供 Zephir 或 C 代码或开发该功能。新功能请求阐明了预期实现的目标,并就如何最好地实现它展开讨论。
所有 NFR 都应作为新问题发布到GitHub。请确保在您的问题标题中使用前缀[NFR]
。