记录新的网络平台

当您为新平台创建网络模块或修改现有网络平台提供的连接（例如 network_cli 和 httpapi）时，您还需要更新 按平台设置 表格，并为您的平台添加或修改平台选项文件。

您应该已经按照 模块格式和文档 中所述记录了每个模块。

修改平台选项表

按平台设置 表格是 Ansible 中每个具有模块的网络平台提供的连接选项的便捷摘要。按字母顺序将您平台的行添加到此表格中。例如

+-------------------+-------------------------+-------------+---------+---------+----------+
| My OS             | ``myos``                | ✓           | ✓       |         | ✓        |

确保表格保持正确的格式。也就是说

• 每行都按字母顺序插入。

• 单元格分隔符 | 标记与 + 标记对齐。

• 复选标记仅出现在网络模块提供的连接类型中。

添加平台特定的选项部分

平台特定的部分是单独的 .rst 文件，为您的网络平台模块的用户提供更详细的信息。将您的新文件命名为 platform_<name>.rst（例如，platform_myos.rst）。平台名称应与模块前缀匹配。请参阅 platform_eos.rst 和 EOS 平台选项，了解您应在平台特定的选项部分中提供的详细信息示例。

您的平台特定部分应包含以下内容

• **可用连接表** - 对每种连接类型进行更深入的探讨，包括有关凭据、间接访问、连接设置和启用模式的详细信息。

• **如何使用每种连接类型** - 提供每种连接类型的有效示例。

如果您的网络平台支持 SSH 连接，请在 .rst 文件的底部也包含以下内容

.. include:: shared_snippets/SSH_warning.txt

将新文件添加到目录表

作为最后一步，按字母顺序将新文件添加到 platform_index.rst 文件中。然后，您应该构建文档以验证您的添加内容。有关更多详细信息，请参阅 为 Ansible 文档贡献代码。