1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00

Removes modules from TOC, speeding up build time and reducing doc disk space requirements.

This commit is contained in:
Scott Butler 2018-04-04 18:55:39 -07:00 committed by Toshio Kuratomi
parent 1c7b9e66b4
commit 62c2b9a544
4 changed files with 12 additions and 15 deletions

View file

@ -1,4 +1,4 @@
:tocdepth: 3 .. _ansible_documentation:
Ansible Documentation Ansible Documentation
===================== =====================
@ -28,19 +28,19 @@ Ansible releases a new major release of Ansible approximately every two months.
porting_guides/porting_guides porting_guides/porting_guides
.. toctree:: .. toctree::
:maxdepth: 3 :maxdepth: 2
:caption: Using Ansible :caption: Using Ansible
user_guide/index user_guide/index
.. toctree:: .. toctree::
:maxdepth: 3 :maxdepth: 2
:caption: Contributing to Ansible :caption: Contributing to Ansible
community/index community/index
.. toctree:: .. toctree::
:maxdepth: 3 :maxdepth: 2
:caption: Extending Ansible :caption: Extending Ansible
dev_guide/index dev_guide/index

View file

@ -8,13 +8,13 @@ To help identify maintainers and understand how the included modules are officia
Core Core
```` ````
:doc:`Core modules are maintained by the Ansible Engineering Team<..\modules\core_maintained>`. :ref:`core_supported`. These are maintained by the Ansible Engineering Team.
These modules are integral to the basic foundations of the Ansible distribution. These modules are integral to the basic foundations of the Ansible distribution.
Network Network
``````` ```````
:doc:`Network modules are maintained by the Ansible Network Team<..\modules\network_maintained>`. Please note there are :doc:`additional networking modules<list_of_network_modules>` that are categorized as Certified or Community not maintained by Ansible. :ref:`network_supported`. These 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
@ -25,7 +25,7 @@ Certified modules are part of a future planned program currently in development.
Community Community
````````` `````````
:doc:`Community modules are submitted and maintained by the Ansible community<..\modules\community_maintained>`. These modules are not maintained by Ansible, and are included as a convenience. :ref:`community_supported`. These are submitted and maintained by the Ansible community. These modules are not maintained by Ansible, and are included as a convenience.
Issue Reporting Issue Reporting
``````````````` ```````````````

View file

@ -7,11 +7,11 @@
@{ blurb }@ @{ blurb }@
{% endif %} {% endif %}
.. toctree:: :maxdepth: 1
{% if category['_modules'] %} {% if category['_modules'] %}
{% for module in category['_modules'] | sort %} {% for module in category['_modules'] | sort %}
@{ module }@{% if module_info[module]['deprecated'] %} **(D)**{% endif%} -- @{ module_info[module]['doc']['short_description'] }@ <@{ module }@_module> * :ref:`@{ module }@`{% if module_info[module]['deprecated'] %} **(D)**{% endif%}
{% endfor %} {% endfor %}
{% endif %} {% endif %}
@ -22,11 +22,10 @@
@{ name.title() }@ @{ name.title() }@
@{ '-' * name | length }@ @{ '-' * name | length }@
.. toctree:: :maxdepth: 1
{% for module in info['_modules'] | sort %} {% for module in info['_modules'] | sort %}
{# :ref:`@{ module }@`{% if module_info[module]['deprecated'] %} **(D)**{% endif%} @{ module_info[module]['doc']['short_description'] }@ #} * :ref:`@{ module }@`{% if module_info[module]['deprecated'] %} **(D)**{% endif%}
@{ module }@{% if module_info[module]['deprecated'] %} **(D)**{% endif%} -- @{ module_info[module]['doc']['short_description'] }@ <@{ module }@_module>
{% endfor %} {% endfor %}
{% endfor %} {% endfor %}

View file

@ -3,10 +3,8 @@
Modules Maintained by the @{ maintainers }@ Modules Maintained by the @{ maintainers }@
``````````````````````````@{ '`' * maintainers | length }@ ``````````````````````````@{ '`' * maintainers | length }@
.. toctree:: :maxdepth: 1
{% for module in modules | sort %} {% for module in modules | sort %}
@{ module }@{% if module_info[module]['deprecated'] %} **(D)**{% endif %} - @{ module_info[module]['doc']['short_description'] }@ <@{ module }@_module> * :ref:`@{ module }@`{% if module_info[module]['deprecated'] %} **(D)**{% endif%}
{% endfor %} {% endfor %}
.. note:: .. note::