贡献指南¶

本项目欢迎广大开发者体验并参与贡献。在参与社区贡献之前，请参见ascend-community了解行为准则，完成CLA协议签署，并了解源码仓的贡献流程。

✍️如何签署Ascend社区贡献者许可协议（CLA）¶

在参与社区贡献前，需签署Ascend社区贡献者许可协议（CLA）：

个人贡献者：请选择「签署个人CLA」，填写好姓名和邮箱后提交申请即可。
企业：请选择「签署法人CLA」，填写企业相关信息，提交申请后，企业将接收到社区发出的签署企业CLA的文件，请按照邮件中的提示完成后续签署。
企业员工：请选择「法人贡献者登记」；签署后会收到主题为 “Signing CLA on project of xx” 的邮件，请联系邮件中的Corporation Managers进行审批。

开发者贡献场景主要包括：

Bug修复

在本项目中发现某些Bug，希望对其进行修复，可新建Issue反馈与跟踪。

可新建Bug-Report|缺陷反馈类Issue描述Bug，然后在评论框中输入“/assign”或“/assign @yourself”，认领该Issue开展处理。
贡献代码

可新建Requirement|需求建议类Issue对新的样例算子予以说明，并提供设计方案，然后在评论框中输入“/assign”或“/assign @yourself”，认领该Issue开展处理。

浏览其他Issue时遵循以下要求：
- 计划解决对应问题，请在问题下评论说明负责处理。
- 若问题已打开较久，解决前请先做预检查。
- 自行提交并修复的问题，关闭前请简要说明处理结果。
问题咨询

使用本项目过程中存在疑问，可新建Issue进行反馈和咨询。

可通过新建Question|问题咨询类Issue提出疑问。
帮助解决他人Issue

若有可行方案解决社区其他开发者遇到的问题，欢迎在Issue中发表评论交流，协助解决问题和痛点，共同优化易用性。

如果对应Issue需要进行代码修改，可在Issue评论框中输入 “/assign” 或 “/assign @yourself”，认领该Issue，跟踪协助解决问题。

本代码仓采用LLVM社区通用的代码规范与编程风格，参见LLVM编码规范。可使用以下工具进行代码风格检查：

在GitCode上提出想法创建Issue。
若新功能涉及较多设计细节，请同时提交设计方案。
在问题讨论与设计方案审查达成共识后，再进行Fork开发并提交PR。
PR经充分讨论后，将根据讨论结果进行合并、拒绝或关闭。
PR合入需2位Reviewer评论/lgtm（Looks Good To Me）及1位Approver评论/approve；PR提交者本人无法执行合入操作。

在向AscendNPU IR项目提交代码前，请先将项目Fork至个人仓库。后续在Fork仓库中进行开发，并通过Pull Request将变更合并到本项目。

完成代码更改后，需在构建目录下编译并运行测试以验证功能：

ninja check-bishengir

代码更新与测试通过后，将commit推送到个人远程仓库。

将代码推送到远程仓库后，在新分支与AscendNPU IR的master分支之间新建Pull Request。创建合并请求后，在PR中评论compile可触发CI构建流水线。建议尽快将PR合并到上游master，以降低合并冲突风险。

代码门禁异常主要包括以下几类，请根据CI提示信息逐项排查并修复。