ansible/docs/docsite/rst
Dag Wieers a22f46bacf Docs: Add a "seealso" section to the module docs (#45949)
* 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 baf0ad2309)
2019-01-28 10:13:05 -08:00
..
api adds stub API docs in a single file (#46663) 2018-11-05 15:10:52 -08:00
community Molecule is now IRC: ansible-molecule (#47860) (#47863) 2018-10-31 09:34:01 -05:00
dev_guide Docs: Add a "seealso" section to the module docs (#45949) 2019-01-28 10:13:05 -08:00
installation_guide [WIP] Backport/2.7/batch port (#45859) 2018-09-19 22:02:01 -05:00
inventory [WIP] Backport/2.7/batch port (#45859) 2018-09-19 22:02:01 -05:00
network Fix prompt mismatch issue for ios (#47004) 2018-10-23 06:34:46 -07:00
plugins Add docs for inventory caching (#46402) 2018-11-05 15:10:52 -08:00
porting_guides [stable-2.7] Add porting guide note about inline vars on import/include_tasks (#47121) (#47130) 2018-10-17 10:50:52 -05:00
reference_appendices added faq entry on ansible_host + delegation (#48438) 2018-11-12 19:30:18 -08:00
roadmap [stable-2.7] bulk docs update (#47828) 2018-10-30 14:45:41 -05:00
scenario_guides Clarify gather_facts and highlight important lines 2019-01-24 10:37:00 -08:00
user_guide link to KB article -certified modules (#50050) (#50052) 2018-12-18 12:16:30 -06:00
vmware [Backport 2.7] VMware: Fix vmware_vm_inventory 2019-01-14 12:35:21 -08:00
conf.py [stable-2.7] -Change: set the 'canonical_url' theme option to enable rendering of canonical urls, promoting the 'latest' docs to search engines. (#49190) (#49214) 2018-11-30 15:40:28 -06:00
index.rst updates language about documentation versions and releases on index page (#46465) 2018-11-05 15:10:52 -08:00