From 3438429e22295c29668cb166ad230333d92bd466 Mon Sep 17 00:00:00 2001 From: Sandra McCann Date: Sun, 14 Oct 2018 20:08:06 -0400 Subject: [PATCH] WIP: fix build errors due to missing certified_supported label (#46835) * fix build errors due to missing certified_supported label * fixed references and toc (cherry picked from commit db3d920cfd9891817d480bb55a50ee7a9521715f) --- docs/bin/plugin_formatter.py | 2 +- .../rst/user_guide/modules_support.rst | 36 +++++++++++-------- 2 files changed, 22 insertions(+), 16 deletions(-) diff --git a/docs/bin/plugin_formatter.py b/docs/bin/plugin_formatter.py index 248b1723b48..85271bafe51 100755 --- a/docs/bin/plugin_formatter.py +++ b/docs/bin/plugin_formatter.py @@ -573,7 +573,7 @@ def process_support_levels(plugin_info, templates, output_dir, plugin_type): " Ansible Network Team` in" " a relationship similar to how the Ansible Core Team" " maintains the Core modules."}, - 'Ansible Partners': {'slug': 'partner_supported', + 'Ansible Partners': {'slug': 'certified_supported', 'modules': [], 'output': 'partner_maintained.rst', 'blurb': """ diff --git a/docs/docsite/rst/user_guide/modules_support.rst b/docs/docsite/rst/user_guide/modules_support.rst index 08affc3b14d..7e7082829f2 100644 --- a/docs/docsite/rst/user_guide/modules_support.rst +++ b/docs/docsite/rst/user_guide/modules_support.rst @@ -1,36 +1,42 @@ .. _modules_support: +**************************** Module Maintenance & Support ----------------------------- +**************************** -.. toctree:: :maxdepth: 1 +..contents:: + :depth: 2 + :local: + +Maintenance +=========== To help identify maintainers and understand how the included modules are officially supported, each module now has associated metadata that provides additional clarity for maintenance and support. Core -```` +---- :ref:`Core Maintained` modules are maintained by the Ansible Engineering Team. These modules are integral to the basic foundations of the Ansible distribution. Network -``````` +------- :ref:`Network Maintained` modules are are maintained by the Ansible Network Team. Please note there are additional networking modules that are categorized as Certified or Community not maintained by Ansible. Certified -````````` +--------- -Certified modules are part of a future planned program currently in development. +:ref:`Certified` modules are maintained by Ansible Partners. Community -````````` +--------- :ref:`Community Maintained` modules are submitted and maintained by the Ansible community. These modules are not maintained by Ansible, and are included as a convenience. Issue Reporting -``````````````` +=============== If you believe you have found a bug in a module and are already running the latest stable or development version of Ansible, first look at the `issue tracker in the Ansible repo `_ to see if an issue has already been filed. If not, please file one. @@ -43,23 +49,23 @@ The modules are hosted on GitHub in a subdirectory of the `Ansible `_ as well as other resources on the `Red Hat Customer Portal. `_ .. seealso:: - :doc:`../modules/modules_by_category` + :ref:`Modules by category` A complete list of all available modules. - :doc:`intro_adhoc` + :ref:`intro_adhoc` Examples of using modules in /usr/bin/ansible - :doc:`playbooks` + :ref:`working_with_playbooks` Examples of using modules with /usr/bin/ansible-playbook - :doc:`../dev_guide/developing_modules` + :ref:`developing_modules` How to write your own modules - :doc:`../dev_guide/developing_api` - Examples of using modules with the Python API + `List of Ansible Certified Modules `_ + High level list of Ansible certified modules from Partners `Mailing List `_ Questions? Help? Ideas? Stop by the list on Google Groups `irc.freenode.net `_