已关闭
[Course-Feedback|课程反馈]: <Ascend C算子开发系列课程> 主 README 缺少"适用学习人群/前置知识"入口章节,初级课程的真实前置要求仅出现在 01.01,入口页无法评估学习适配度 #252
创建于  7月29日关闭于  28 天前
涛
7月29日 创建

Thanks for sending an issue! Please fill in the following template to help quickly solve your problem.

一、课程名称 (必填)

Ascend C算子开发系列课程(Kernel 直调),仓库相对索引:tutorials/ascendc_operator_development_light/README.md

二、反馈类型 (必填)

课程难度/节奏反馈

三、反馈详情 (必填)

章节/小节:课程主 README(入口文档)

问题位置tutorials/ascendc_operator_development_light/README.md 第 1–53 行。当前主 README 仅含:标题与一段简介、"教程按章节划分"说明、一条"仅针对 Atlas A2 系列"注意、四章 notebook 跳转表;无"适用学习人群/前置知识"章节、无结构化"支持的硬件产品"章节、无"已验证的在线体验环境(含内核版本)"说明。

背景与难点

课程对外定位"初级"(目录名 _light、主 README 标题"Ascend C 算子开发系列教程"),但实际前置要求不低:01.01 单元格[1]"前置要求"列出 C/C++(变量/循环/指针/函数)、深度学习基础、计算机体系结构、Python/NumPy、Linux 等 7 项。这些要求决定了"初级"是否对学习者成立,是入门者判断是否适合开始学习的关键信息。

学习者操作

  1. 从仓库 tutorials/ 进入 ascendc_operator_development_light/README.md(课程入口)。
  2. 阅读主 README,判断是否适合开始学习、需要准备什么。
  3. 决定是否直接点击第一章链接开始。

实际结果

(静态核对主 README)

主 README 全文不含"适用学习人群""前置要求/前置知识"章节,也未结构化列出"支持的硬件产品"与"已验证的在线体验环境(内核版本)"。学习者从入口页只能看到章节表与一句"仅针对 Atlas A2 系列",无法在入口处评估自身是否满足前置能力。前置要求实际仅出现在 01_basic_overview/01.01_chapter_intro.ipynb 单元格[1]内,需点击进入第一章第一节才能看到。

预期结果

主 README 作为课程入口,应包含"适用学习人群(含基础要求与前置课程)""支持的硬件产品""已验证的在线体验环境"等章节(与 docs/course_submission_criteria.md 3.2 节主 README 要求及 PR 准入第 7 项一致),使学习者在入口页即可判断适配度。前置要求内容已存在于 01.01,仅需上提汇总到主 README。

根因

首个偏离预期的位置为主 README 缺少上述入口章节;根因为课程入口文档未按验收标准汇总已在子章节存在的人群/硬件/环境信息,属内容组织缺口,非子章节内容缺失。

影响

  • 受影响人群:首次接触本课程、从仓库入口评估是否学习的开发者,尤其被"初级"标签吸引但不确定自身基础是否达标的学习者。
  • 学习影响:入口页看不到前置要求,可能误判为"零基础可学"而直接开始,直到进入 01.01 才发现需要 C++/指针/体系结构等基础;或反向——具备基础的学习者因入口信息不足而低估课程价值。影响为认知错配与少量试错,不阻塞学习。
  • 修复价值:在主 README 汇总前置要求与硬件/环境信息后,学习者在入口即可自我评估,减少错配。

建议改法

  1. tutorials/ascendc_operator_development_light/README.md 简介之后、章节目录之前,新增"适用学习人群"章节,将 01.01 单元格[1]的 7 项前置要求上提汇总(C/C++、深度学习基础、计算机体系结构、Python/NumPy、Linux 等),并注明"无须 Ascend C 前置知识"。
  2. 新增结构化"支持的硬件产品"章节,明确写出已验证型号(当前为 Atlas A2 训练/推理系列),并保留"其它产品可能存在问题"的说明。
  3. 新增"已验证的在线体验环境"章节:写明 gitcode 在线 notebook 为已验证路径,并给出目标 Python 内核版本(与 Issue 2 统一的内核一致);如适用 CANNLab,按验收标准补 NPU 镜像模板名与内核版本及 CANNLab 环境体验指南链接。
likedislike
涛
7月29日 修改标题为 “[Course-Feedback|课程反馈]: Ascend C算子开发系列课程 主 README 缺少"适用学习人群/前置知识"入口章节,初级课程的真实前置要求仅出现在 01.01,入口页无法评估学习适配度”,原标题为“[Course-Feedback|课程反馈]: 主 README 缺少"适用学习人群/前置知识"入口章节,初级课程的真实前置要求仅出现在 01.01,入口页无法评估学习适配度”
涛
7月29日 修改标题为 “[Course-Feedback|课程反馈]: <Ascend C算子开发系列课程> 主 README 缺少"适用学习人群/前置知识"入口章节,初级课程的真实前置要求仅出现在 01.01,入口页无法评估学习适配度”,原标题为“[Course-Feedback|课程反馈]: Ascend C算子开发系列课程 主 README 缺少"适用学习人群/前置知识"入口章节,初级课程的真实前置要求仅出现在 01.01,入口页无法评估学习适配度”
ink_polymer
ink_polymer成员
7月30日 评论:

尊敬的开发者您好,您的建议已收到,待内部评估后反馈,感谢您的支持

likedislike
ink_polymerink_polymer成员
7月30日 将 YANXI_ZHAO 设为负责人
YYANXI_ZHAO成员
8月4日 issue状态由 进行中 改变为 已完成
YYANXI_ZHAO成员
8月4日 关闭了 issue
YYANXI_ZHAO成员
8月4日 issue状态由 已完成 改变为 已确认
YYANXI_ZHAO成员
8月4日 重新打开了 issue
YYANXI_ZHAO成员
28 天前 关联了pull request:docs: 补充Ascend C light课程适用信息
YYANXI_ZHAO成员
28 天前 关联了pull request:docs: 补充Ascend C light课程适用信息
CANN-robotCANN-robot成员
28 天前 关闭了 issue
CANN-robotCANN-robot成员
28 天前 添加了label:resolved
chenmingyu
chenmingyu成员
27 天前 评论:

尊敬的开发者,您好!
您提出的issue已在关联的PR中解决,感谢您的贡献,如果有其他问题,欢迎在issue中讨论

likedislike