已关闭
【文档质量】QUICKSTART.md 同篇前后不一致:第一章用 ${soc_version} 占位,第二章重编译却写死 ascend910b #3636
brian66237创建于  6月27日关闭于  7月23日
brian66237
6月27日 创建

问题类型:文档自相矛盾(同篇或同算子几份之间)
文档:docs/QUICKSTART.md
严重程度:会让人困惑 / 走弯路或误判,但能恢复


问题

第一章教读者按本机芯片填 --soc=${soc_version},但第二章「重新编译」那条命令把芯片写死成 --soc=ascend910b

读者会遇到什么

非 910b 芯片(910_93/950)的读者照第二章粘贴,会把包编成 910b 的,与本机不匹配。

代码原文 / 实际情况(去仓核对)

docs/QUICKSTART.md(第 55 行)·第一章:占位符,让读者按本机填:

  55 | bash build.sh --pkg --soc=${soc_version} --ops=add_example -j16

docs/QUICKSTART.md(第 152 行)·第二章「重新编译」:写死 ascend910b:

 152 |     bash build.sh --pkg --soc=ascend910b --ops=add_example -j16

build.sh(第 14 行)·build.sh 支持的芯片(910b 只是其中之一):

  14 | SUPPORT_COMPUTE_UNIT_SHORT=("ascend031" "ascend035" "ascend310b" "ascend310p" "ascend910_93" "ascend950" "ascend350" "ascend910b" "ascend910" "kirinx90" "kirin9030" "mc62")

代码位置(完整指引)

  • QUICKSTART.md:55 第一章 --soc=${soc_version}
  • QUICKSTART.md:152 第二章 --soc=ascend910b(写死)
  • build.sh:14 SUPPORT_COMPUTE_UNIT_SHORT 列出全部支持芯片

建议改为

第二章「重新编译」命令也改用 --soc=${soc_version},与第一章一致。

likedislike
oscillated
oscillated成员
6月27日 评论:

您好,感谢反馈,问题已收到,当前 @caiwenwen 正在跟踪处理。

likedislike
oscillatedoscillated成员
6月30日 将 caiwenwen 设为负责人
Ccaiwenwen成员
7月17日 将 yolic 设为负责人
Ccaiwenwen成员
7月17日 移除了负责人 caiwenwen
yuning_chenyuning_chen成员
7月23日 将 liyuanqiang 设为负责人
Lliyuanqiang成员
7月23日 关联了pull request:docs: fix aclnnAddmm sample results and QUICKSTART soc placeholder
CANN-robotCANN-robot成员
7月23日 关闭了 issue
CANN-robotCANN-robot成员
7月23日 添加了label:resolved