diff --git a/docs/bin/plugin_formatter.py b/docs/bin/plugin_formatter.py index b620fa9206c..5581d0dd489 100755 --- a/docs/bin/plugin_formatter.py +++ b/docs/bin/plugin_formatter.py @@ -409,16 +409,45 @@ def process_categories(mod_info, categories, templates, output_dir, output_name) def process_support_levels(mod_info, templates, output_dir): supported_by = {'Ansible Core Team': {'slug': 'core_supported', 'modules': [], - 'output': 'core_maintained.rst'}, + 'output': 'core_maintained.rst', + 'blurb': "These are :doc:`modules maintained by the" + " Ansible Core Team` and will always ship" + " with Ansible itself."}, 'Ansible Network Team': {'slug': 'network_supported', 'modules': [], - 'output': 'network_maintained.rst'}, + 'output': 'network_maintained.rst', + 'blurb': "These are :doc:`modules maintained by the" + " Ansible Network Team` in" + " a relationship similar to how the Ansible Core Team" + " maintains the Core modules."}, 'Ansible Partners': {'slug': 'partner_supported', 'modules': [], - 'output': 'partner_maintained.rst'}, + 'output': 'partner_maintained.rst', + 'blurb': """ +Some examples of :doc:`Certified Modules` are those submitted by other +companies. Maintainers of these types of modules must watch for any issues reported or pull requests +raised against the module. + +The Ansible Core Team will review all modules becoming certified. Core committers will review +proposed changes to existing Certified Modules once the community maintainers of the module have +approved the changes. Core committers will also ensure that any issues that arise due to Ansible +engine changes will be remediated. Also, it is strongly recommended (but not presently required) +for these types of modules to have unit tests. + +These modules are currently shipped with Ansible, but might be shipped separately in the future. +"""}, 'Ansible Community': {'slug': 'community_supported', 'modules': [], - 'output': 'community_maintained.rst'}, + 'output': 'community_maintained.rst', + 'blurb': """ +These are :doc:`modules maintained by the Ansible Community`. They **are +not** supported by the Ansible Core Team or by companies/partners associated to the module. + +They are still fully usable, but the response rate to issues is purely up to the community. Best +effort support will be provided but is not covered under any support contracts. + +These modules are currently shipped with Ansible, but will most likely be shipped separately in the future. + """}, } # Separate the modules by support_level diff --git a/docs/docsite/rst/conf.py b/docs/docsite/rst/conf.py index 5b39e1c76a3..6a8edca13e8 100644 --- a/docs/docsite/rst/conf.py +++ b/docs/docsite/rst/conf.py @@ -225,6 +225,6 @@ latex_documents = [ autoclass_content = 'both' -intersphinx_mapping = {'python': ('https://docs.python.org/2', (None, '../python2-2.7.13.inv')), - 'python3': ('https://docs.python.org/3', (None, '../python3-3.6.2.inv')), - 'jinja2': ('http://jinja.pocoo.org/docs', (None, 'jinja2-2.9.7.inv'))} +intersphinx_mapping = {'python': ('https://docs.python.org/2/', (None, '../python2-2.7.13.inv')), + 'python3': ('https://docs.python.org/3/', (None, '../python3-3.6.2.inv')), + 'jinja2': ('http://jinja.pocoo.org/docs/', (None, '../jinja2-2.9.7.inv'))} diff --git a/docs/docsite/rst/modules_support.rst b/docs/docsite/rst/modules_support.rst index 71f71a7ead1..1789b8ec147 100644 --- a/docs/docsite/rst/modules_support.rst +++ b/docs/docsite/rst/modules_support.rst @@ -18,46 +18,34 @@ The modules are hosted on GitHub in a subdirectory of the `ansible ` modules +These are :doc:`modules maintained by the Ansible Core Team` +and will always ship with Ansible itself. Network ``````` -These modules are supported by the Ansible Network Team in a relationship +These are :doc:`modules maintained by the Ansible Network Team` in a relationship similar to how the Ansible Core Team maintains the Core modules. -.. seealso:: - List of :ref:`Network Supported` modules - Certified ````````` -Some examples of Certified modules are those submitted by other companies. Maintainers of these types of modules must watch for any issues reported or pull requests raised against the module. +Some examples of :doc:`Certified Modules` are those submitted by other companies. Maintainers of these types of modules must watch for any issues reported or pull requests raised against the module. -Core Committers will review all modules becoming Certified. Core Committers will review proposed changes to existing Certified modules once the community maintainers of the module have approved the changes. Core committers will also ensure that any issues that arise due to Ansible engine changes will be remediated. +The Ansible Core Team will review all modules becoming certified. Core committers will review proposed changes to existing Certified Modules once the community maintainers of the module have approved the changes. Core committers will also ensure that any issues that arise due to Ansible engine changes will be remediated. Also, it is strongly recommended (but not presently required) for these types of modules to have unit tests. These modules are currently shipped with Ansible, but might be shipped separately in the future. -.. seealso:: - List of :ref:`Certified` modules - Community ````````` -These modules **are not** supported by Core Committers or by companies/partners associated to the module. They are maintained by the community. + +These are :doc:`modules maintained by the Ansible Community`. They **are not** supported by the Ansible Core Team or by companies/partners associated to the module. They are still fully usable, but the response rate to issues is purely up to the community. Best effort support will be provided but is not covered under any support contracts. These modules are currently shipped with Ansible, but will most likely be shipped separately in the future. -.. seealso:: - List of Core Supported modules - List of :ref:`Community Supported` modules - .. seealso:: diff --git a/docs/templates/list_of_CATEGORY_modules.rst.j2 b/docs/templates/list_of_CATEGORY_modules.rst.j2 index d54564a057c..483ca7aa288 100644 --- a/docs/templates/list_of_CATEGORY_modules.rst.j2 +++ b/docs/templates/list_of_CATEGORY_modules.rst.j2 @@ -1,6 +1,10 @@ @{ title }@ Modules @{ '`' * title | length }@```````` +{% if blurb %} +@{ blurb }@ + +{% endif %} .. toctree:: :maxdepth: 1 {% if category['_modules'] %} @@ -16,7 +20,7 @@ .. toctree:: :maxdepth: 1 {% for module in info['_modules'] | sort %} - @{ module }@{% if module_info[module]['deprecated'] %}**(D)**{% endif%} - @{ module_info[module]['doc']['short_description'] }@ <@{ module }@_module> + @{ module }@{% if module_info[module]['deprecated'] %} **(D)**{% endif%} - @{ module_info[module]['doc']['short_description'] }@ <@{ module }@_module> {% endfor %} {% endfor %} diff --git a/docs/templates/modules_by_support.rst.j2 b/docs/templates/modules_by_support.rst.j2 index 2a155b0fe13..d40c3e1712a 100644 --- a/docs/templates/modules_by_support.rst.j2 +++ b/docs/templates/modules_by_support.rst.j2 @@ -6,7 +6,7 @@ Modules Maintained by the @{ maintainers }@ .. toctree:: :maxdepth: 1 {% for module in modules | sort %} - @{ module }@{% if module_info[module]['deprecated'] %}**(D)**{% endif %} - @{ module_info[module]['doc']['short_description'] }@ <@{ module }@_module> + @{ module }@{% if module_info[module]['deprecated'] %} **(D)**{% endif %} - @{ module_info[module]['doc']['short_description'] }@ <@{ module }@_module> {% endfor %} .. note:: diff --git a/docs/templates/plugin.rst.j2 b/docs/templates/plugin.rst.j2 index 947cbde1920..b6e87517b0b 100644 --- a/docs/templates/plugin.rst.j2 +++ b/docs/templates/plugin.rst.j2 @@ -279,15 +279,13 @@ Status This module is flagged as **@{cur_state}@** which means that @{module_states[cur_state]}@. {% endfor %} {% endif %} +{% if metadata.supported_by in ('core', 'network') %} -{% if metadata.supported_by %} +Maintenance Info +~~~~~~~~~~~~~~~~ -Support Level -~~~~~~~~~~~~~ - -This module is maintained by @{ support[metadata.supported_by] }@ - -For more information on what this means please read :doc:`modules_support`. +For more information about Red Hat's this support of this module, please +refer to this `knowledge base article` {% endif %} {% endif %}