When you create network modules for a new platform, or modify the connections provided by an existing network platform(such as
httpapi), you also need to update the Settings by Platform table and add or modify the Platform Options file for your platform.
You should already have documented each module as described in Module format and documentation.
The Settings by Platform table is a convenient summary of the connections options provided by each network platform that has modules in Ansible. Add a row for your platform to this table, in alphabetical order. For example:
+-------------------+-------------------------+-------------+---------+---------+----------+ | My OS | ``myos`` | ✓ | ✓ | | ✓ |
Ensure that the table stays formatted correctly. That is:
|markers line up with the
The platform- specific sections are individual
.rst files that provide more detailed information for the users of your network platform modules. Name your new file
platform_<name>.rst (for example,
platform_myos.rst). The platform name should match the module prefix. See platform_eos.rst and EOS Platform Options for an example of the details you should provide in your platform-specific options section.
Your platform-specific section should include the following:
If your network platform supports SSH connections, also include the following at the bottom of your
.. include:: shared_snippets/SSH_warning.txt
As a final step, add your new file in alphabetical order in the
platform_index.rst file. You should then build the documentation to verify your additions. See Contributing to the Ansible Documentation for more details.
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.