算子数据类型扩展 提交流程¶
飞桨作为一个开源项目，我们鼓励生态开发者为 PaddlePaddle 完善和优化各类算子，当你想为飞桨扩展数据类型的支持时，请遵守下述贡献流程，在 GitHub 上完成文档设计和代码设计并提交至相应的 GitHub 仓库。
算子数据类型扩展贡献流程¶
流程介绍¶
1. 任务认领
如果你想参与飞桨 OP 开源贡献，可以在 GitHub Paddle 项目上的 Issue 区域进行任务认领，飞桨官方会发布一些 OP 优化任务，你可以认领其中的算子数据类型扩展任务，并按照此贡献流程提交算子数据类型扩展的设计文档。
2. 签订贡献者许可协议（CLA）
对于你贡献的源代码，你将拥有合法的知识产权，为了保护你的权益，你需要先签署一份 贡献者许可协议 。
注意：只有当你签署完 CLA 后，我们才能继续对你提交的设计方案和实现代码进行评审及合入。
3. 根据开发难点提交必要的设计文档
算子数据类型扩展是针对飞桨已有的算子，因此可以只在必要情况下提供设计文档：
不需要提供设计文档：如果算子性能符合预期，比如算子使用 FP16 数据类型的计算性能明显优于使用 FP32 数据类型，代码实现中仅涉及了算子的功能增强，则不需要撰写设计文档。我们鼓励开发者在进行算子数据类型扩展时首先进行方案设计，你可以将自己的设计思路提交在 PR 中。
需要提供设计文档：如果算子在扩展了数据类型后性能不符合预期，例如为算子扩展了 FP16 数据类型，但是性能却差于使用 FP32 数据类型计算，则需要针对 FP16 数据类型实现性能的优化，这种情况下需要添加算子性能优化设计文档，这也是为了促进社区开发者更容易的参与开源项目共建，开发者通过与飞桨专家和社区其他用户进行广泛的交流，完善设计方案和 PR 请求，在提交实现代码之前确保方案符合飞桨的设计理念，同时也便于后续的代码评审及合入工作。你需要将设计文档提交至 GitHub 开发者社区仓库，并根据本地开发指南提交 PR。此过程请参考相应的开发规范，并提交以下内容：
提交内容 |
参考文档 |
提交位置 |
|---|---|---|
算子性能优化设计文档 |
4. 设计文档评审&公示
针对需要提供设计文档的算子，飞桨专家会对你提交的设计文档进行审核，同时此文档也将接受来自开发者社区的评估，所有开发者都可以在 PR 评论区进行广泛的交流。开发者根据飞桨专家和其他开发者的反馈意见进行讨论并做出修改，最终评审通过后会合入。
如果你的设计方案比较复杂，会在社区中针对算子的设计文档发起评审会议。飞桨会提前在 PR 评论区公布会议时间、会议地址、参会人、议题等内容，请及时关注 pr 中最新动态，你也可以在评论区自行申请评审会。会议结束后，会在 PR 中发出会议结论。
5. 公布评审结果&合入文档
当设计文档评审&公示通过后，你的算子优化设计文档将会合入至 飞桨开发者社区仓库 ，并在开源社区中同步。
6. 提交算子优化代码
随后，你可以根据评审通过的设计内容进行代码开发。此过程请参考相应的开发规范，并提交以下内容：
提交内容 |
参考文档 |
提交位置 |
|---|---|---|
1、算子数据类型扩展实现代码 |
||
2、API 英文文档 |
||
3、API 中文文档 |
||
4、算子不同数据类型性能对比 |
当你完成以上代码设计后，需要将代码提交至 Github 飞桨训练框架仓库 和 Github 飞桨中文文档仓库 ，并根据 本地开发指南 提交 PR、准备接受社区的评审。
7. 实现代码评审&公示
飞桨官方会及时安排专家进行算子优化代码审核，代码也将接受来自开发者社区的评审，所有开发者可以在 PR 评论区进行交流。请你对飞桨专家和其他开发者的反馈意见进行讨论并做出修改，最终评审通过后会在开源社区中同步。
如果你的代码实现逻辑比较复杂，会在社区中针对算子的设计文档发起评审会议。飞桨会提前在 PR 评论区公布会议时间、会议地址、参会人、议题等内容，请及时关注 pr 中最新动态，你也可以在评论区自行申请评审会。会议结束后，会在 PR 中发出会议结论。
8. 公布评审结果&合入代码
当算子优化代码评审&公示通过，官方会在开源社区中同步，你所实现的优化代码将会合入至 Github 飞桨训练框架仓库 。
9. 通过集成测试、精度和性能验收
当你的代码合入 Github 飞桨训练框架仓库 后，飞桨会对你的优化代码进行模型级别的集成测试、精度和性能的验收，并告知你测试结果。如果测试通过，恭喜你贡献流程已经全部完成。如果测试不通过，会通过 ISSUE 联系你进行代码修复，请及时关注 GitHub 上的最新动态。
注意：代码合入 develop 分支之后的第二天，你可以从官网下载 develop 安装包体验此功能。飞桨后续也会将此功能纳入下一个正式版的发版计划。
10. 贡献完成
感谢你的贡献！