已合并
[Doc] API 参考文档对齐当前 CLI:参数改用规范名并对齐配置文档与文档规范 #483 #860
[Doc] API 参考文档对齐当前 CLI:参数改用规范名并对齐配置文档与文档规范 #483 #860
已合并
rookie_hongchuan创建于 6 天前
rookie_hongchuan成员
6 天前

关联 issue:#483

1. 影响面评估

接口变更(按需):

仅文档表述,不涉及代码接口。

输出件变更(按需):

非兼容变更(按需):

SIG 评审结论(按需):

纯文档改动,无接口/安全/架构变更,无需 SIG 评审。

2. 修改描述

修改背景(可选): CLI 已把参数改用规范名(--config_path--config
--tag--tags--pattern--patterns--topk--top_k),但已合入的 API 参考
文档仍沿用旧名称,且部分配置文档/docstring 与文档规范(数字单位间距、术语、标题标号)未对齐。

修改目的: 让 API 参考与配置文档对齐当前 CLI 契约与文档规范,消除文档与实现漂移。

修改内容:(按「概念 - 变化」分条)

  • cli:quant/analyze/tune 命令行 API 文档改用规范名 --config/--tags/--patterns/--top_k
    补充 --device_id/--log_level/-v/-q,修正 --trust_remote_code 与设备语义
  • config:api_reference/config/** 相关配置文档按文档规范统一描述与术语
  • docs:docs_standards 的 01/03 checklist 与模板按标题标号与规范修订

3. 功能验证

冒烟由 CI 门禁检查,无需填写「冒烟是否通过」。

复现步骤(可选): N/A(纯文档改动)

4. 自检(请逐项确认,不适用标 N/A)

典型安全编码问题

DT

likedislike
Pull Request已成功合入, 合并人@ascend-robot
(感谢 rookie_hongchuan 的贡献)
Rrookie_hongchuan成员
6 天前 关联了issue:[Doc]: API 参考文档参数与当前 CLI 不一致,需按规范名对齐
atomgit-bot
atomgit-bot
6 天前 评论:

变更摘要

本 PR 为纯文档改动,目标是让 API 参考文档与配置文档对齐当前 CLI 契约及文档规范,消除文档与实现之间的漂移。由于 CLI 已把参数改用规范名(--config_path--config--tag--tags--pattern--patterns--topk--top_k),而已合入的 API 参考文档仍沿用旧名称,本 PR 对 quant/analyze/tune 命令行 API 文档、api_reference/config/** 配置文档及 docs_standards 规范模板进行同步修订,不涉及任何代码接口、安全或架构变更。

主要改动

  • CLI 参数名对齐规范名quant/analyze/tune 命令行 API 参考文档将旧参数 --config_path/--tag/--pattern/--topk 改用规范名 --config/--tags/--patterns/--top_k,使文档与当前 CLI 契约一致。
  • 补充缺失参数并修正语义:补充 --device_id/--log_level/-v/-q 等参数说明,并修正 --trust_remote_code 与设备相关的语义描述。
  • 配置文档统一描述与术语api_reference/config/** 相关配置文档按文档规范统一描述与术语,与配置文档及 docstring 保持对齐。
  • 文档规范模板修订docs_standards 的 01/03 checklist 与模板按标题标号与文档规范要求进行修订。
likedislike
atomgit-bot
atomgit-bot
6 天前 评论:

🤖 本次改动均为数据 / 生成 / 二进制文件(如测试用例、锁文件、媒体资源),没有可审查的代码逻辑,已跳过 AI 代码审查。

likedislike
ascend-robotascend-robot成员
6 天前 添加了label:ascend-cla/yes
此处折叠了68条消息 查看更多
libowen
libowen成员
2 天前 评论:

/lgtm

likedislike
ascend-robotascend-robot成员
2 天前 添加了label:lgtm
LeeQT成员
2 天前 评论:

/approve

likedislike
ascend-robotascend-robot成员
2 天前 添加了label:approved
ascend-robotascend-robot成员
2 天前 合入了pull request