已关闭
[Course-Feedback|课程反馈]: Ascend C 初级课程 4 组图片的 alt 文本被复用到不同图片上,其中 alt="turing_test" 被用在 6 张图(含 5 张融合算子相关图),与图灵测试无关 #524
不喜欢雨天ༀ创建于  8月3日关闭于  8月7日
不喜欢雨天ༀ
不喜欢雨天ༀ
8月3日 创建

一、课程名称

Ascend C 算子开发初级课程(light)— 第 1、2、3、4 章均涉及

tutorials/ascendc_operator_development_light/,分支:master(评优文档对该课程限定 master 分支)

二、反馈类型

课程内容错误(图片 alt 替代文本与图片内容不符)

三、反馈详情

本课程有 4 组 alt 文本被复用到多张不同的图片上。以下逐组列出,并按文件名给出建议的 alt。

第 1 组:alt="turing_test" 被用在 6 张图上

引用位置 图片文件 alt 是否相符
01_basic_overview/01.02_ai_and_operator_basics.ipynb cell#1 turing_test.png 相符(原始正确用法)
03_simple_operator_practice/03.04_fused_operator_concept_intro.ipynb cell#2 mix_process.png 不符
03_simple_operator_practice/03.05_cv_fused_operator_development.ipynb cell#5 a2_frame.png 不符
03_simple_operator_practice/03.05_cv_fused_operator_development.ipynb cell#7 data_trends.png 不符
03_simple_operator_practice/03.05_cv_fused_operator_development.ipynb cell#7 offset.png 不符
03_simple_operator_practice/03.05_cv_fused_operator_development.ipynb cell#7 result.png 不符

turing_test(图灵测试)是第 1 章讲 AI 基础概念时的配图,而第 3 章这 5 张图分别是混合流程、A2 架构框图、数据趋势、偏移示意和运行结果,都属于融合算子开发内容,与图灵测试没有任何关系。从形态看是从 01.02 复制了 <img> 标签后只改了 src 而未改 alt。

建议的 alt:mix_process.png → 混合计算流程;a2_frame.png → A2 架构框图;data_trends.png → 数据变化趋势;offset.png → 偏移量示意;result.png → 运行结果。

第 2 组:alt="trace" 被用在 4 张图上

均位于 04_debug/04.04_simulation_analysis.ipynb:

cell 图片文件 建议 alt
cell#13 trace_info.png trace 信息(相符)
cell#17 chose_file.png 选择文件
cell#18 timeline.png 时间线视图
cell#19 code_info.png 代码信息

四张图分别是 trace 信息、文件选择、时间线和代码信息,属仿真分析流程的不同步骤,用同一个 trace 无法区分。

第 3 组:alt="prof_no_printf" 被用在 2 张图上

引用位置 图片文件
04_debug/04.03_profiling_tool_usage.ipynb cell#26 no_printf.png
04_debug/04.04_simulation_analysis.ipynb cell#26 no_print_trace.png

两张图分属 Profiling 工具使用与仿真分析两节,文件名也不同(no_printf 与 no_print_trace),但 alt 相同。第二处建议改为能区分 trace 场景的描述。

第 4 组:alt="tiling_32" 被用在 2 张图上

均位于 02_AscendC_basic/02.05_generalized_tiling_design.ipynb:

cell 图片文件 内容(据文件名与所在小节)
cell#7 core_data_split.png 核间数据拆分(对应小节 3.4.2)
cell#8 kernel_data_split.png 核内数据切分(对应小节 3.4.3)

tiling_32 对应的是 32 字节对齐(小节 3.4.1),而这两张图讲的是核间拆分与核内切分。这一组尤其值得修正:核间拆分与核内切分是本节最容易混淆的两个概念(该 notebook 的 3.4.2「核间数据拆分」与 3.4.3「核内数据切分」是并列小节),两张图用同一个与二者都无关的 alt,无法起到区分作用。

影响

  1. 图片加载失败时显示错误信息。这些 notebook 使用 <img src="./images/…"> 相对路径引用本地图片。在 GitCode 网页端预览 notebook、或将 notebook 导出为 HTML 后移动位置时,相对路径可能失效,此时浏览器显示的就是 alt 文本。学习者会在第 3 章融合算子章节看到「turing_test」,无法据此判断缺失的是哪张图。
  2. 无障碍访问。屏幕阅读器朗读的是 alt 文本。6 张图都被读作「turing_test」,使用读屏工具的学习者完全无法区分。
  3. 影响按图检索。学习者或维护者想定位某张图的引用位置时,alt 是最直观的线索;4 组复用会导致检索结果指向错误的位置。
  4. 第 3 章那组尤其影响理解。03.05_cv_fused_operator_development.ipynb 的 cell#7 一次引用了 3 张图(data_trends.png、offset.png、result.png),三张图的 alt 全是 turing_test,读者从 alt 完全看不出它们分别在讲什么。

全范围扫描结果

对评优清单内 11 门课程做同标准扫描(统计「同一 alt 指向 ≥2 个不同图片文件」的情形,排除空 alt 与 image、img、图片 这类占位 alt):

课程 alt 复用组数
tutorials/ascendc_operator_development_light 4(本条)
tutorials/hixl_development 2(其中 1 组已由 #471 反映)
cann_basics / CANNBot / llm_inference / rl / TorchAir / ge / pyasc / autofusion / sft 0

即该问题只存在于两门课程,其余 9 门为 0,无误报。

顺带说明 hixl 的情况供参考:其中一组 alt="中转Buffer开销示意" 被用在 buffer_transfer_overhead.png、fabricmem_d2rh_flow.png、fabricmem_memory_mapping.png 三张图上,后两张即 #471 所报的 FabricMem 两张图;另一组 alt="HIXL 多链路高速互连" 同时用于 multi_highspeed_link.png 与 third_party_integration.png(01.03_hixl_introduction.ipynb cell#1),后者是第三方集成示意,与「多链路高速互连」不符,该组尚未见有人反映。

同类先例

#471(HIXL FabricMem 两张图的 alt 文本误写成「中转 Buffer 开销示意」)反映的是完全相同的形态——alt 被复制粘贴后未同步修改。本条是该问题在 light 课程的 4 组实例。

改进建议

  1. 按上文四组表格逐项修正 alt,使其与图片实际内容对应。改动都在 <img> 标签内,不影响正文。
  2. 优先处理第 1 组(turing_test 用在 6 张图)与第 4 组(tiling_32 用在核间/核内两张图),前者数量最多、后者最影响概念区分。
  3. hixl 的 alt="HIXL 多链路高速互连" 那组(third_party_integration.png)建议与 #471 一并处理。
  4. 流程建议:这条检查规则简单且误报极低——把文档中所有 <img src alt> 与 ![alt](src) 提取出来,按 alt 聚合,若同一 alt 指向 2 个以上不同文件名即报警(需排除空 alt 与占位 alt)。在 11 门课程上运行的输出只有 6 组,全部为真。建议纳入课件提交前检查,它能有效捕捉「复制 <img> 标签后只改 src」这一常见操作遗漏。

四、环境信息

  • 课程路径:tutorials/ascendc_operator_development_light/
  • 涉及文件:01_basic_overview/01.02_ai_and_operator_basics.ipynb、02_AscendC_basic/02.05_generalized_tiling_design.ipynb、03_simple_operator_practice/03.04_fused_operator_concept_intro.ipynb、03_simple_operator_practice/03.05_cv_fused_operator_development.ipynb、04_debug/04.03_profiling_tool_usage.ipynb、04_debug/04.04_simulation_analysis.ipynb
  • 分支:master
  • 核查方式:同时解析 HTML <img> 标签(src/alt 两种书写顺序)与 Markdown ![alt](src) 语法,按 alt 文本聚合其指向的图片文件名集合,仅报「同一 alt 指向 ≥2 个不同文件」的组;排除空 alt 与 image/img/图片/示意图 等占位文本
likedislike
ink_polymer
ink_polymer成员
8月3日 评论:

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

likedislike
ApeiriaNode_Booker
ApeiriaNode_Booker
8月6日 评论:

您好,感谢您的反馈,我们会尽快修复。

likedislike
ApeiriaNode_BookerApeiriaNode_Booker
8月7日 关联了pull request:fix: 修复 Ascend C light 课程反馈问题
ApeiriaNode_BookerApeiriaNode_Booker
8月7日 关联了pull request:fix(test): 修复 Ascend C light 课程反馈问题
ApeiriaNode_Booker
ApeiriaNode_Booker
8月7日 评论:

已在关联的PR中修复,该issue关闭。感谢您的参与。

likedislike
Mmeme成员
8月7日 issue状态由 进行中 改变为 已完成
Mmeme成员
8月7日 关闭了 issue
CANN-robotCANN-robot成员
8月7日 添加了label:resolved