Closed
[Documentation|文档反馈]: 规范 RaggedBinCount 多产品差异说明 #2919
raoliang_sacAdd on  Aug 27Closed at  Sep 19
raoliang_sacCollaborators
Aug 27 Create

一、文档链接 (必填)

https://gitcode.com/cann/ops-math/blob/master/math/ragged_bin_count/README.md

二、问题文档片段 (必填)

RaggedBinCount 原 README 的参数说明将 values 统一描述为 1D 或 2D,未单独说明 Ascend 950 与 A2/A3 等产品的 rank 差异;约束说明还承诺了非法输入时输出保持按位 +0.0、Kernel 提前返回等实现细节,容易被误解为稳定接口契约。

💡 存在的问题

  • 通用参数表与产品特有能力混写,无法准确识别 Ascend 950 支持 rank 1~2、其他已支持产品支持 rank 0~2 的差异。
  • 非法输入行为描述混入 Kernel 内部处理方式,超出了 README 应承诺的接口语义。
  • 调用说明和数据类型写法需要按当前算子 README 规范统一。

预期将通用参数能力与产品差异分开描述,保留真实接口约束,并明确本算子仅支持 GE 图模式调用。

关联 PR:https://gitcode.com/cann/ops-math/merge_requests/5141

补充关联 PR(已带入同一文档修改):
https://gitcode.com/cann/ops-math/merge_requests/5138

likedislike
Rraoliang_sacCollaborators
Aug 27 Added label: documentation
Rraoliang_sacCollaborators
Aug 27 Assign raoliang_sac as responsible person
Rraoliang_sacCollaborators
Aug 27 Modify description of issue
Ssongkai111Collaborators
Sep 19 changed custom state from 进行中 to 已完成
Ssongkai111Collaborators
Sep 19 Close issue