mirror of https://github.com/ansible/ansible.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
a22f46bacf
* Docs: Add a separate "seealso" section to the module docs
to list related modules and/or related references. This clears up the notes
section for things that are actual notes.
So you can add a section in your module documentation and four types of
references are possible.
seealso:
# Reference by module name
- module: aci_tenant
# Reference by module name, including description
- module: aci_tenant
description: ACI module to create tenants on a Cisco ACI fabric.
# Reference by rST documentation anchor
- ref: aci_guide
description: Detailed information on how to manage your ACI infrastructure using Ansible.
# Reference by Internet resource
- name: APIC Management Information Model reference
description: Complete reference of the APIC object model.
link: https://developer.cisco.com/docs/apic-mim-ref/
This PR also includes:
- Implements ansible-doc support
- Implements schema support for the seealso options
- Updates to the development documentation
- Rename filter convert_symbols_to_format to rst_ify, cfr the existing html_ify and tty_ify filters
- This makes the existing template a lot easier to read and fixes the confusion I had myself rereading the template (again).
- We fixed the possible suboption types (which was limited to 'bool' only)
* Use latest stable instead of devel docs
(cherry picked from commit
|
7 years ago | |
|---|---|---|
| .. | ||
| shared_snippets | 7 years ago | |
| style_guide | 7 years ago | |
| testing/sanity | 7 years ago | |
| Makefile | 9 years ago | |
| debugging.rst | 7 years ago | |
| developing_api.rst | 7 years ago | |
| developing_core.rst | 7 years ago | |
| developing_inventory.rst | 7 years ago | |
| developing_locally.rst | 7 years ago | |
| developing_module_utilities.rst | 7 years ago | |
| developing_modules.rst | 7 years ago | |
| developing_modules_best_practices.rst | 7 years ago | |
| developing_modules_checklist.rst | 7 years ago | |
| developing_modules_documenting.rst | 7 years ago | |
| developing_modules_general.rst | 7 years ago | |
| developing_modules_general_aci.rst | 7 years ago | |
| developing_modules_general_windows.rst | 7 years ago | |
| developing_modules_in_groups.rst | 7 years ago | |
| developing_plugins.rst | 7 years ago | |
| developing_program_flow_modules.rst | 7 years ago | |
| developing_python_3.rst | 7 years ago | |
| developing_rebasing.rst | 7 years ago | |
| index.rst | 7 years ago | |
| module_lifecycle.rst | 7 years ago | |
| overview_architecture.rst | 7 years ago | |
| testing.rst | 7 years ago | |
| testing_compile.rst | 7 years ago | |
| testing_documentation.rst | 7 years ago | |
| testing_httptester.rst | 7 years ago | |
| testing_integration.rst | 7 years ago | |
| testing_pep8.rst | 7 years ago | |
| testing_running_locally.rst | 7 years ago | |
| testing_sanity.rst | 7 years ago | |
| testing_units.rst | 7 years ago | |
| testing_units_modules.rst | 7 years ago | |
| testing_validate-modules.rst | 7 years ago | |