[Docs] 修改rst文件路径适配paddle url, 同步paconvert修改部分api的类别，完善差异文档生成脚本#7571
Closed
hd9568 wants to merge 8 commits into
Closed
[Docs] 修改rst文件路径适配paddle url, 同步paconvert修改部分api的类别，完善差异文档生成脚本#7571hd9568 wants to merge 8 commits into
hd9568 wants to merge 8 commits into
Conversation
hd9568
requested review from
Echo-Nie,
jzhang533,
mattheliu,
ooooo-create and
sunzhongkai588
as code owners
|
感谢你贡献飞桨文档，文档预览构建中，Docs-New 跑完后即可预览，预览链接：http://preview-pr-7571.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/zh/api/index_cn.html |
📚 本次 PR 文档预览链接（点击展开）
|
zhwesky2010
reviewed
Oct 22, 2025
Collaborator
zhwesky2010
left a comment
zhwesky2010
left a comment
There was a problem hiding this comment.
torch.Tensor.hardshrink 仍然是 『仅参数名不一致』，不应该从 args_name_diff里删除
zhwesky2010
reviewed
Oct 23, 2025
| "NumelMatcher", | ||
| "Is_InferenceMatcher", | ||
| ]: | ||
| special_matchers = { |
Collaborator
There was a problem hiding this comment.
这里直接分两类来写吧。
if in ...
elif in ...
| continue | ||
| else: | ||
| # 属于 invok_diff_only，继续后续处理 | ||
| pass # 继续执行下面的文档生成逻辑 |
Collaborator
There was a problem hiding this comment.
这里的分支逻辑、代码风格 还是要优化下，尽量少用 pass 这些占位符
| @@ -1,16 +1,18 @@ | |||
| ## [ torch 参数更多 ]torch.Tensor.bernoulli | |||
| ### [torch.Tensor.bernoulli](https://pytorch.org/docs/stable/generated/torch.Tensor.bernoulli.html#torch.Tensor.bernoulli) | |||
| ## [ 仅参数名不一致 ]torch.Tensor.bernoulli | |||
Collaborator
There was a problem hiding this comment.
这里的paconvert实现有点问题，这个数据是冗余的，这个仍然是 仅API调用方式不一致
后面有个地方要注意：就是paconvert数据可能不一定准确，你要注意自己看下api_difference是不是正确的，如果api_difference明显不对，那么说明paconvert可能是错的。paconvert的问题同样需要修复。
| | <font color='red'> lambd </font> | <font color='red'> threshold </font> | Hardshrink 阈值，仅参数名不一致。 | | ||
| | PyTorch | PaddlePaddle | 备注 | | ||
| | ------- | ------------ | ----------------------------- | | ||
| | lambd | threshold | 阈值，仅参数名不一致，功能一致 | |
Collaborator
There was a problem hiding this comment.
类方法改普通方法，统一在前面加一个
| self | x | （这个描述你想想怎么描述） |
| @@ -1,21 +0,0 @@ | |||
| ## [ 仅参数名不一致 ]torch.Tensor.ormqr | |||
| @@ -0,0 +1,15 @@ | |||
| ## [ 仅 API 调用方式不一致 ]torch.Tensor.pinverse | |||
| @@ -1,4 +1,4 @@ | |||
| ## [ 仅参数名不一致 ]torch.autograd.function.FunctionCtx.mark_non_differentiable | |||
| ## [ 仅 API 调用方式不一致 ]torch.autograd.function.FunctionCtx.mark_non_differentiable | |||
| name=None) | ||
| ``` | ||
|
|
||
| 其中 PyTorch 与 Paddle 指定 `dim` 后返回值不一致，具体如下： |
|
|
||
| ### [paddle.median](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/api/paddle/median_cn.html#median) | ||
| ```python | ||
| paddle.median(x, axis=None, keepdim=False, mode='avg', name=None) |
Collaborator
There was a problem hiding this comment.
这个是paddle.compat.median，这个是否是根据api_mapping.json来生成的？
Contributor
Author
There was a problem hiding this comment.
这里是旧文档的写法，得升级完validate_docs后才能把这些问题解决
| @@ -1,4 +1,4 @@ | |||
| ## [ 返回参数类型不一致 ]torch.min | |||
| ## [ 仅 API 调用方式不一致 ]torch.min | |||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.