已关闭
[Course-Feedback|课程反馈]: MC2 课程 02.07 中 3 处引用 01.06_ 前缀链接失效,且答案子目录名拼写为 anwser_02_10 #453
不喜欢雨天ༀ创建于  8月3日关闭于  8月18日
不喜欢雨天ༀ
不喜欢雨天ༀ
8月3日 创建

一、课程名称

MC2 融合算子开发系列教程 — 第二章 MoE 基础算子教程

路径:tutorials/MC2_fused_operator_development/02_MoE_basic_operator_tutorial/(test 分支)

二、反馈类型

课程内容错误(内部链接失效 + 目录命名拼写错误)

三、反馈详情

问题 1:02.07_win_memory_layout.ipynb 中 3 处引用 01.06_ 前缀,链接失效

位置 当前链接 实际文件
02.07_win_memory_layout.ipynb cell[3](2 处) ./01.06_dispatch_combine_core_flow.ipynb 02.06_dispatch_combine_core_flow.ipynb
02.07_win_memory_layout.ipynb cell[4](1 处) ./01.06_dispatch_combine_core_flow.ipynb 02.06_dispatch_combine_core_flow.ipynb

该章节目录下的 Notebook 实际为 02.01 ~ 02.10,不存在任何 01.* 文件,因此这 3 处跳转均失效。

本章节目录实际内容:

02.01_chapter_intro.ipynb
02.02_moe_architexture_overview.ipynb
02.03_parallel_strategy.ipynb
02.04_dispatch_combine_operator.ipynb
02.05_operator_logic_overview.ipynb
02.06_dispatch_combine_core_flow.ipynb
02.07_win_memory_layout.ipynb
02.08_tiling_guide.ipynb
02.09_kernel_stage_guide.ipynb
02.10_quant_dispatch_practice.ipynb
README.md
answer/
images/
scaffold_02_10/

问题 2:答案子目录名拼写错误(anwser 应为 answer)

answer/ 目录实际内容:

answer/02.02_answer.txt
answer/02.03_answer.txt
answer/02.04_answer.txt
answer/anwser_02_10/01_buffer_size_calc.txt
answer/anwser_02_10/02_send_flow.txt
answer/anwser_02_10/03_receive_flow.txt

其中子目录 anwser_02_10 将 answer 拼写为 anwser。同目录下三个答案文件均使用正确拼写 02.0X_answer.txt,仅该子目录拼错,属明显笔误。这类拼写错误容易在后续引用中被沿用,建议尽早更正。

复现步骤

  1. 列出章节目录与答案目录的实际内容:

    ls tutorials/MC2_fused_operator_development/02_MoE_basic_operator_tutorial/
    ls -R tutorials/MC2_fused_operator_development/02_MoE_basic_operator_tutorial/answer/
    
  2. 统计失效链接的出现次数(结果为 3):

    grep -o "01\.06_dispatch_combine_core_flow" \
      tutorials/MC2_fused_operator_development/02_MoE_basic_operator_tutorial/02.07_win_memory_layout.ipynb | wc -l
    
  3. 确认目标文件的正确名称存在:

    ls tutorials/MC2_fused_operator_development/02_MoE_basic_operator_tutorial/02.06_dispatch_combine_core_flow.ipynb
    

与已有反馈的区别

已有反馈 #367 反映的是 scaffold 路径问题(脚手架被错误写在 answer/ 目录下、以及 scaffold_01_10 应为 scaffold_02_10)与一处 01.07_win_memory_layout 链接。本反馈补充两个该反馈未涉及的点:

  1. 02.07 中 3 处 01.06_dispatch_combine_core_flow 链接(应为 02.06_);
  2. 答案子目录 anwser_02_10 的拼写错误 —— #367 在描述中将 answer/anwser_02_10/ 作为"实际答案目录"引用,未指出其中的拼写问题。

改进建议

  1. 将 02.07_win_memory_layout.ipynb 中 3 处 01.06_dispatch_combine_core_flow.ipynb 更正为 02.06_dispatch_combine_core_flow.ipynb。
  2. 将 answer/anwser_02_10/ 更正为 answer/answer_02_10/,并同步更新引用该路径的位置。
  3. 建议在 CI 中增加 Notebook 内部相对链接可达性检查,可批量拦截此类章节编号前缀错误。

四、环境信息

  • 课程路径:tutorials/MC2_fused_operator_development/02_MoE_basic_operator_tutorial/
  • 分支:test
  • 校验基线 commit:5c79d26
likedislike
ink_polymer
ink_polymer成员
8月3日 评论:

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

likedislike
不喜欢雨天ༀ
不喜欢雨天ༀ
8月12日 评论:

/assign

likedislike
CANN-robotCANN-robot成员
8月12日 将 2403_87936996 设为负责人
不喜欢雨天ༀ不喜欢雨天ༀ
8月12日 关联了pull request:fix(mc2): 修复 MoE 教程脚手架与章节路径
jiangxiuhan
jiangxiuhan
8月17日 评论:
likedislike
chenmingyu
chenmingyu成员
8月18日 评论:

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

likedislike
chenmingyuchenmingyu成员
8月18日 issue状态由 进行中 改变为 已完成
chenmingyuchenmingyu成员
8月18日 关闭了 issue