第一次想给昇腾CANN做贡献最让我头秃的是不知道从哪下手GitHub仓库这么多到底改哪个PR怎么提代码规范是啥后来混熟了才发现cann-community是昇腾AI的社区大本营所有社区项目、贡献指南、行业应用案例都在这里。cann-community是什么cann-community是昇腾CANN生态的社区项目聚合平台提供社区项目、贡献指南、行业应用案例。在CANN五层架构里cann-community位于第0层应用使能层作为社区平台被开发者调用聚合所有仓库cann-docs、cann-samples、cann-tools、cann-blogs等提供贡献指南从环境搭建到PR提交流程手把手带你做贡献为什么需要社区平台你可能会问昇腾CANN的GitHub仓库不是开源的吗为什么还需要cann-community答案在聚合与降低门槛。没有社区平台的痛点太分散核心仓库在atomgit.com/cann文档在cann.io教程在B站. 到处都是找不到系统性的学习路径。门槛高想做贡献但不知道从哪下手PR流程是啥代码规范是啥.缺案例行业应用案例智慧城市、医疗、金融找不到只能自己摸索。cann-community的优势系统性从入门到精通有完整学习路线低门槛贡献指南手把手教你提PR、写文档、做测试有案例行业应用案例智慧城市、医疗、金融都有直接参考cann-community的核心内容cann-community提供以下核心内容1. 社区项目Community Projectscann-community聚合了以下社区项目项目内容适用人群cann-docs社区贡献的文档API、教程、FAQ所有人cann-samples社区贡献的代码示例从Hello World到大模型推理初学者cann-tools社区贡献的工具ATC插件、msadvisor插件、cann-op-devkit模板开发者cann-blogs社区贡献的技术博客算子优化、性能调优、行业趋势所有人cann-community社区项目聚合平台本文档所有人关键点所有社区项目都开源atomgit.com/cann可以随时提PR贡献。2. 贡献指南Contribution Guidecann-community提供了以下贡献指南贡献流程环境搭建安装CANN 8.0、配置环境变量、跑通第一个样例选择贡献类型文档贡献、代码贡献、博客贡献Fork仓库Fork要贡献的仓库、Clone到本地、创建分支做贡献改错别字、修bug、加功能、写博客提交PR提交改动、提PR、等待审核3个工作日内关键点贡献指南覆盖了文档贡献、代码贡献、博客贡献三种类型手把手教你提PR。3. 行业应用案例Industry Use Casescann-community提供了以下行业应用案例智慧城市目标检测用PP-YOLOe做目标检测性能95 FPSAscend 910代码from cann.samples import PP_YOLOe医疗语义分割用DeepLabV3做语义分割性能18 images/sAscend 910代码from cann.samples import DeepLabV3金融时间序列预测用LSTM做时间序列预测性能1250 samples/sAscend 910代码from cann.samples import LSTM关键点所有行业应用案例都有完整代码和性能基准。【唯一的代码段 - 完整贡献流程】实战给cann-community做贡献完整流程# 第1步Fork仓库 # 1. Fork仓库在atomgit.com/cann/cann-docs点Fork # 2. Clone到本地 git clone https://atomgit.com/your-username/cann-docs.git cd cann-docs # 3. 创建分支 git checkout -b fix-typo-in-readme # 第2步修错别字 # 打开README.md vim README.md # 找到错别字假设第10行有错别字 # 原文昇腾CANN是华为开放的开源AI计算架构 # 改正昇腾CANN是华为开源的AI计算架构删除开放 # 保存退出 # 第3步提交改动 # 1. 添加改动 git add README.md # 2. 提交改动 git commit -m fix: correct typo in README.md (remove redundant 开放) # 3. 推送到远程 git push origin fix-typo-in-readme # 第4步提PR # 1. 打开PR页面在atomgit.com/your-username/cann-docs/pulls/new # 2. 填写PR描述 # - 标题fix: correct typo in README.md # - 描述删除了README.md第10行中冗余的开放二字 # - 关联Issue无 # 3. 提交PR # 第5步等待审核 # 1. 等待审核社区维护者会在3个工作日内审核 # 2. 如果审核通过你的PR会被合并 # 3. 如果审核不通过根据反馈修改后重新提交代码段解释用文字讲解第1-2步Fork仓库 修错别字标准流程第3步提交改动git add commit push第4步提PR填写标题、描述、关联Issue第5步等待审核3个工作日内审核通过/不通过常见踩坑点坑1PR被拒症状PR提交后被维护者拒绝。原因改动不符合代码规范如缩进、命名等改动没有测试如没跑通cann-samples的测试改动描述不清晰如PR标题写fix bug但没说是什么bug解决方案看代码规范在cann-community/contribution-guide/code-style.md跑通测试在cann-samples/run_tests.sh写清晰的PR描述标题 描述 关联Issue坑2环境搭不起来症状Fork仓库后本地环境搭不起来CANN安装失败、环境变量配置不对等。原因系统不满足要求如Ubuntu版本太低环境变量配置不对如ASCEND_HOME没设置解决方案看环境要求在cann-community/contribution-guide/environment-setup.md跟着教程搭环境在cann-learning-hub/environment-setup.md坑3不知道贡献啥症状想做贡献但不知道从哪下手。原因对昇腾CANN不熟悉不知道有哪些仓库、哪些项目技能不匹配如只会写文档不会写代码解决方案看社区项目列表在cann-community/projects.md看贡献类型文档贡献、代码贡献、博客贡献从简单的开始如修错别字、补文档下一步想深入学怎么给昇腾CANN做贡献cann-community有系列教程从环境搭建到PR提交流程手把手带你做贡献https://atomgit.com/cann/cann-community顺便说一句如果你想进入昇腾CANN社区cann-community是必看的。不做贡献永远只是使用者做贡献才能成为贡献者。
cann-community - 昇腾AI社区大本营仓库：cann-community
第一次想给昇腾CANN做贡献最让我头秃的是不知道从哪下手GitHub仓库这么多到底改哪个PR怎么提代码规范是啥后来混熟了才发现cann-community是昇腾AI的社区大本营所有社区项目、贡献指南、行业应用案例都在这里。cann-community是什么cann-community是昇腾CANN生态的社区项目聚合平台提供社区项目、贡献指南、行业应用案例。在CANN五层架构里cann-community位于第0层应用使能层作为社区平台被开发者调用聚合所有仓库cann-docs、cann-samples、cann-tools、cann-blogs等提供贡献指南从环境搭建到PR提交流程手把手带你做贡献为什么需要社区平台你可能会问昇腾CANN的GitHub仓库不是开源的吗为什么还需要cann-community答案在聚合与降低门槛。没有社区平台的痛点太分散核心仓库在atomgit.com/cann文档在cann.io教程在B站. 到处都是找不到系统性的学习路径。门槛高想做贡献但不知道从哪下手PR流程是啥代码规范是啥.缺案例行业应用案例智慧城市、医疗、金融找不到只能自己摸索。cann-community的优势系统性从入门到精通有完整学习路线低门槛贡献指南手把手教你提PR、写文档、做测试有案例行业应用案例智慧城市、医疗、金融都有直接参考cann-community的核心内容cann-community提供以下核心内容1. 社区项目Community Projectscann-community聚合了以下社区项目项目内容适用人群cann-docs社区贡献的文档API、教程、FAQ所有人cann-samples社区贡献的代码示例从Hello World到大模型推理初学者cann-tools社区贡献的工具ATC插件、msadvisor插件、cann-op-devkit模板开发者cann-blogs社区贡献的技术博客算子优化、性能调优、行业趋势所有人cann-community社区项目聚合平台本文档所有人关键点所有社区项目都开源atomgit.com/cann可以随时提PR贡献。2. 贡献指南Contribution Guidecann-community提供了以下贡献指南贡献流程环境搭建安装CANN 8.0、配置环境变量、跑通第一个样例选择贡献类型文档贡献、代码贡献、博客贡献Fork仓库Fork要贡献的仓库、Clone到本地、创建分支做贡献改错别字、修bug、加功能、写博客提交PR提交改动、提PR、等待审核3个工作日内关键点贡献指南覆盖了文档贡献、代码贡献、博客贡献三种类型手把手教你提PR。3. 行业应用案例Industry Use Casescann-community提供了以下行业应用案例智慧城市目标检测用PP-YOLOe做目标检测性能95 FPSAscend 910代码from cann.samples import PP_YOLOe医疗语义分割用DeepLabV3做语义分割性能18 images/sAscend 910代码from cann.samples import DeepLabV3金融时间序列预测用LSTM做时间序列预测性能1250 samples/sAscend 910代码from cann.samples import LSTM关键点所有行业应用案例都有完整代码和性能基准。【唯一的代码段 - 完整贡献流程】实战给cann-community做贡献完整流程# 第1步Fork仓库 # 1. Fork仓库在atomgit.com/cann/cann-docs点Fork # 2. Clone到本地 git clone https://atomgit.com/your-username/cann-docs.git cd cann-docs # 3. 创建分支 git checkout -b fix-typo-in-readme # 第2步修错别字 # 打开README.md vim README.md # 找到错别字假设第10行有错别字 # 原文昇腾CANN是华为开放的开源AI计算架构 # 改正昇腾CANN是华为开源的AI计算架构删除开放 # 保存退出 # 第3步提交改动 # 1. 添加改动 git add README.md # 2. 提交改动 git commit -m fix: correct typo in README.md (remove redundant 开放) # 3. 推送到远程 git push origin fix-typo-in-readme # 第4步提PR # 1. 打开PR页面在atomgit.com/your-username/cann-docs/pulls/new # 2. 填写PR描述 # - 标题fix: correct typo in README.md # - 描述删除了README.md第10行中冗余的开放二字 # - 关联Issue无 # 3. 提交PR # 第5步等待审核 # 1. 等待审核社区维护者会在3个工作日内审核 # 2. 如果审核通过你的PR会被合并 # 3. 如果审核不通过根据反馈修改后重新提交代码段解释用文字讲解第1-2步Fork仓库 修错别字标准流程第3步提交改动git add commit push第4步提PR填写标题、描述、关联Issue第5步等待审核3个工作日内审核通过/不通过常见踩坑点坑1PR被拒症状PR提交后被维护者拒绝。原因改动不符合代码规范如缩进、命名等改动没有测试如没跑通cann-samples的测试改动描述不清晰如PR标题写fix bug但没说是什么bug解决方案看代码规范在cann-community/contribution-guide/code-style.md跑通测试在cann-samples/run_tests.sh写清晰的PR描述标题 描述 关联Issue坑2环境搭不起来症状Fork仓库后本地环境搭不起来CANN安装失败、环境变量配置不对等。原因系统不满足要求如Ubuntu版本太低环境变量配置不对如ASCEND_HOME没设置解决方案看环境要求在cann-community/contribution-guide/environment-setup.md跟着教程搭环境在cann-learning-hub/environment-setup.md坑3不知道贡献啥症状想做贡献但不知道从哪下手。原因对昇腾CANN不熟悉不知道有哪些仓库、哪些项目技能不匹配如只会写文档不会写代码解决方案看社区项目列表在cann-community/projects.md看贡献类型文档贡献、代码贡献、博客贡献从简单的开始如修错别字、补文档下一步想深入学怎么给昇腾CANN做贡献cann-community有系列教程从环境搭建到PR提交流程手把手带你做贡献https://atomgit.com/cann/cann-community顺便说一句如果你想进入昇腾CANN社区cann-community是必看的。不做贡献永远只是使用者做贡献才能成为贡献者。
