BrilliantYuKaimin

【不要合入】以 Conv1D 为例给出一个成对 API 的减少冗余的写法

3

在 paddle 的 nn 目录下，有很多成对的 API，比如 nn.Conv1D 和 nn.functional.conv1d。目前飞桨 API 文档中对这些成对 API 的描述存在大量冗余（在两个文档中存在几乎同样的内容）。在 PyTorch 的文档中，[函数的文档](https://pytorch.org/docs/stable/generated/torch.nn.functional.conv1d.html)会请读者从[类的文档](https://pytorch.org/docs/stable/generated/torch.nn.Conv1d.html)中获取更多细节。但我更建议在类的文档中请读者从函数的文档中获取更多细节，因为类的实例其实是对应函数的一个特例（调用类的实例的 `forward` 方法时只需要给出输入，而不需要再指出其他参数）。 这个 PR 以 nn.Conv1D 为例，给出一个减少重复内容的写法。调整的方面有： - 对类的描述只说这个类的实例是对应函数的特殊情形。 - 简化与对应函数同名的参数的描述。 - 删去“形状”，因为形状应当是一个算法的前置条件（precondition）和后置条件（postcondition）的一部分，所以应该在对应函数中给出。 - 将“属性”更名为“可学习参数”。...