已关闭
[Course-Feedback|课程反馈]: Ascend C 初级课程 4 组图片的 alt 文本被复用到不同图片上,其中 alt="turing_test" 被用在 6 张图(含 5 张融合算子相关图),与图灵测试无关 #524
不喜欢雨天ༀ创建于 8月3日关闭于 8月7日
ink_polymer
8月3日 评论:
8月3日 评论:
尊敬的开发者您好,您的建议已收到,待内部评估后反馈,感谢您的支持


ApeiriaNode_Booker
8月6日 评论:
8月6日 评论:
您好,感谢您的反馈,我们会尽快修复。


8月7日 关联了pull request:fix: 修复 Ascend C light 课程反馈问题
8月7日 关联了pull request:fix(test): 修复 Ascend C light 课程反馈问题
ApeiriaNode_Booker
8月7日 评论:
8月7日 评论:
已在关联的PR中修复,该issue关闭。感谢您的参与。


8月7日 添加了label:resolved
一、课程名称
Ascend C 算子开发初级课程(light)— 第 1、2、3、4 章均涉及
tutorials/ascendc_operator_development_light/,分支:master(评优文档对该课程限定 master 分支)二、反馈类型
课程内容错误(图片 alt 替代文本与图片内容不符)
三、反馈详情
本课程有 4 组
alt文本被复用到多张不同的图片上。以下逐组列出,并按文件名给出建议的 alt。第 1 组:
alt="turing_test"被用在 6 张图上01_basic_overview/01.02_ai_and_operator_basics.ipynbcell#1turing_test.png03_simple_operator_practice/03.04_fused_operator_concept_intro.ipynbcell#2mix_process.png03_simple_operator_practice/03.05_cv_fused_operator_development.ipynbcell#5a2_frame.png03_simple_operator_practice/03.05_cv_fused_operator_development.ipynbcell#7data_trends.png03_simple_operator_practice/03.05_cv_fused_operator_development.ipynbcell#7offset.png03_simple_operator_practice/03.05_cv_fused_operator_development.ipynbcell#7result.pngturing_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:trace_info.pngchose_file.pngtimeline.pngcode_info.png四张图分别是 trace 信息、文件选择、时间线和代码信息,属仿真分析流程的不同步骤,用同一个
trace无法区分。第 3 组:
alt="prof_no_printf"被用在 2 张图上04_debug/04.03_profiling_tool_usage.ipynbcell#26no_printf.png04_debug/04.04_simulation_analysis.ipynbcell#26no_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:core_data_split.pngkernel_data_split.pngtiling_32对应的是 32 字节对齐(小节 3.4.1),而这两张图讲的是核间拆分与核内切分。这一组尤其值得修正:核间拆分与核内切分是本节最容易混淆的两个概念(该 notebook 的 3.4.2「核间数据拆分」与 3.4.3「核内数据切分」是并列小节),两张图用同一个与二者都无关的 alt,无法起到区分作用。影响
<img src="./images/…">相对路径引用本地图片。在 GitCode 网页端预览 notebook、或将 notebook 导出为 HTML 后移动位置时,相对路径可能失效,此时浏览器显示的就是 alt 文本。学习者会在第 3 章融合算子章节看到「turing_test」,无法据此判断缺失的是哪张图。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):tutorials/ascendc_operator_development_lighttutorials/hixl_development即该问题只存在于两门课程,其余 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.ipynbcell#1),后者是第三方集成示意,与「多链路高速互连」不符,该组尚未见有人反映。同类先例
#471(HIXL FabricMem 两张图的 alt 文本误写成「中转 Buffer 开销示意」)反映的是完全相同的形态——alt 被复制粘贴后未同步修改。本条是该问题在 light 课程的 4 组实例。
改进建议
<img>标签内,不影响正文。turing_test用在 6 张图)与第 4 组(tiling_32用在核间/核内两张图),前者数量最多、后者最影响概念区分。alt="HIXL 多链路高速互连"那组(third_party_integration.png)建议与 #471 一并处理。<img src alt>与提取出来,按 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<img>标签(src/alt两种书写顺序)与 Markdown语法,按 alt 文本聚合其指向的图片文件名集合,仅报「同一 alt 指向 ≥2 个不同文件」的组;排除空 alt 与image/img/图片/示意图等占位文本