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.
04e816e13b
Raise the bar for module `DOCUMENTAION` This validator update was used to find the issues in https://github.com/ansible/ansible/pull/22297/files **Validation** * Updated Validation and docs to enforce more (items fixed in https://github.com/ansible/ansible/pull/22297/files) * Use `suboptions` to document complex options * Validate module name * Validate deprecated modules have correct ANSIBLE_METADATA **Module Documentation Generation** * Document `suboptions:` Example https://gist.github.com/gundalow/4bdc3669d696268328ccc18528cc6718 * Tidy up HTML generation (valid HTML, no empty lists, etc) **Documentation** * Clarify the steps for deprecating a module * Use correct RST headings * Document `suboptions:` (options) * Document `contains:` (returns) **Details** The aim is to get this (and corresponding module updates) complete by the time `devel` becomes `2.4`, as this allows us to raise the bar for new modules Example `suboptions` https://gist.github.com/gundalow/4bdc3669d696268328ccc18528cc6718 The aim is to get this PR integrated into `devel` *before* we branch `stable-2.3`, this will allows us to: * Raise the bar for new modules in 2.4 * Ensure the generated module documentation for 2.3 and higher is improved, important as we will be doing versioned docs moving forward. |
8 years ago | |
|---|---|---|
| .. | ||
| dev_guide | 8 years ago | |
| modules | 8 years ago | |
| roadmap | 8 years ago | |
| YAMLSyntax.rst | 8 years ago | |
| become.rst | 8 years ago | |
| committer_guidelines.rst | 8 years ago | |
| common_return_values.rst | 8 years ago | |
| community.rst | 8 years ago | |
| conf.py | 8 years ago | |
| faq.rst | 8 years ago | |
| galaxy.rst | 8 years ago | |
| glossary.rst | 8 years ago | |
| guide_aws.rst | 8 years ago | |
| guide_azure.rst | 8 years ago | |
| guide_cloudstack.rst | 8 years ago | |
| guide_docker.rst | 8 years ago | |
| guide_gce.rst | 8 years ago | |
| guide_rax.rst | 8 years ago | |
| guide_rolling_upgrade.rst | 8 years ago | |
| guide_vagrant.rst | 8 years ago | |
| guides.rst | 8 years ago | |
| index.rst | 8 years ago | |
| intro.rst | 8 years ago | |
| intro_adhoc.rst | 8 years ago | |
| intro_bsd.rst | 8 years ago | |
| intro_configuration.rst | 8 years ago | |
| intro_dynamic_inventory.rst | 8 years ago | |
| intro_getting_started.rst | 8 years ago | |
| intro_installation.rst | 8 years ago | |
| intro_inventory.rst | 8 years ago | |
| intro_networking.rst | 8 years ago | |
| intro_patterns.rst | 8 years ago | |
| intro_windows.rst | 8 years ago | |
| modules.rst | 8 years ago | |
| modules_intro.rst | 8 years ago | |
| modules_support.rst | 8 years ago | |
| playbooks.rst | 8 years ago | |
| playbooks_acceleration.rst | 8 years ago | |
| playbooks_advanced_syntax.rst | 8 years ago | |
| playbooks_async.rst | 8 years ago | |
| playbooks_best_practices.rst | 8 years ago | |
| playbooks_blocks.rst | 8 years ago | |
| playbooks_checkmode.rst | 8 years ago | |
| playbooks_conditionals.rst | 8 years ago | |
| playbooks_debugger.rst | 8 years ago | |
| playbooks_delegation.rst | 8 years ago | |
| playbooks_environment.rst | 8 years ago | |
| playbooks_error_handling.rst | 8 years ago | |
| playbooks_filters.rst | 8 years ago | |
| playbooks_filters_ipaddr.rst | 8 years ago | |
| playbooks_intro.rst | 8 years ago | |
| playbooks_lookups.rst | 8 years ago | |
| playbooks_loops.rst | 8 years ago | |
| playbooks_prompts.rst | 8 years ago | |
| playbooks_roles.rst | 8 years ago | |
| playbooks_special_topics.rst | 8 years ago | |
| playbooks_startnstep.rst | 8 years ago | |
| playbooks_strategies.rst | 8 years ago | |
| playbooks_tags.rst | 8 years ago | |
| playbooks_templating.rst | 8 years ago | |
| playbooks_tests.rst | 8 years ago | |
| playbooks_variables.rst | 8 years ago | |
| playbooks_vault.rst | 8 years ago | |
| porting_guide_2.0.rst | 8 years ago | |
| python_3_support.rst | 8 years ago | |
| quickstart.rst | 8 years ago | |
| test_strategies.rst | 8 years ago | |
| tower.rst | 8 years ago | |