From 9f3a40570691390aed716487b36d89a24c4588eb Mon Sep 17 00:00:00 2001 From: Abhijeet Kasurde Date: Mon, 15 May 2017 17:53:46 +0530 Subject: [PATCH] Fix URLs in dev_guide documentation (#24533) Signed-off-by: Abhijeet Kasurde --- docs/docsite/rst/dev_guide/developing_modules_checklist.rst | 4 ++-- docs/docsite/rst/dev_guide/developing_modules_general.rst | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/docsite/rst/dev_guide/developing_modules_checklist.rst b/docs/docsite/rst/dev_guide/developing_modules_checklist.rst index 19570993c8..2a846040d9 100644 --- a/docs/docsite/rst/dev_guide/developing_modules_checklist.rst +++ b/docs/docsite/rst/dev_guide/developing_modules_checklist.rst @@ -33,7 +33,7 @@ The following checklist items are important guidelines for people who want to c 'supported_by': 'community', 'metadata_version': '1.0'} -The complete module metadata specification is here: https://docs.ansible.com/ansible/dev_guide/developing_modules_documenting.html#ansible-metadata-block +The complete module metadata specification is here: `Ansible metadata block `_ * Documentation: Make sure it exists * Module documentation should briefly and accurately define what each module and option does, and how it works with others in the underlying system. Documentation should be written for broad audience--readable both by experts and non-experts. This documentation is not meant to teach a total novice, but it also should not be reserved for the Illuminati (hard balance). @@ -76,7 +76,7 @@ The complete module metadata specification is here: https://docs.ansible.com/ans * Avoid catchall exceptions, they are not very useful unless the underlying API gives very good error messages pertaining the attempted action. * Module-dependent guidelines: Additional module guidelines may exist for certain families of modules. * Be sure to check out the modules themselves for additional information. - * Amazon: https://github.com/ansible/ansible/blob/devel/lib/ansible/modules/cloud/amazon/GUIDELINES.md + * `Amazon `_ * Modules should make use of the "extends_documentation_fragment" to ensure documentation available. For example, the AWS module should include:: extends_documentation_fragment: diff --git a/docs/docsite/rst/dev_guide/developing_modules_general.rst b/docs/docsite/rst/dev_guide/developing_modules_general.rst index edc029a5c6..032d594b8c 100644 --- a/docs/docsite/rst/dev_guide/developing_modules_general.rst +++ b/docs/docsite/rst/dev_guide/developing_modules_general.rst @@ -311,7 +311,7 @@ Supporting Check Mode ````````````````````` .. versionadded:: 1.1 -Modules may optionally support `check mode `. If the user runs Ansible in check mode, a module should try to predict and report whether changes will occur but not actually make any changes (modules that do not support check mode will also take no action, but just will not report what changes they might have made). +Modules may optionally support `check mode `_. If the user runs Ansible in check mode, a module should try to predict and report whether changes will occur but not actually make any changes (modules that do not support check mode will also take no action, but just will not report what changes they might have made). For your module to support check mode, you must pass ``supports_check_mode=True`` when instantiating the AnsibleModule object. The AnsibleModule.check_mode attribute will evaluate to True when check mode is enabled. For example: