modules missing examples

[samccann]

Summary

Someone pointed out that the modules/plugins don't have examples listed.

Issue Type

Documentation Report

Component Name

autoscaling_launch_configuration.py

Ansible Version

$ ansible --version

Collection Versions

$ ansible-galaxy collection list

Configuration

$ ansible-config dump --only-changed

OS / Environment

No response

Additional Information

No response

Code of Conduct

• [X] I agree to follow the Ansible Code of Conduct

[alinabuzachis]

@samccann Thank you for raising this issue. This collection is auto-generated using the https://github.com/ansible-community/ansible.content_builder. EXAMPLES block is filled using the integration tests examples. In this collection, not all the modules are covered by integration tests and which is why some are lacking examples.

[samccann]

Thanks for the explanation @alinabuzachis . FYI - we've got some customer feedback on another collection (vmware_rest) that suggests integration tests as examples aren't always helpful (aka seen as less real-world than if someone hand-crafted the examples to match a real-world use case). Still in discussion but wanted to share that bit of early feedback.

[alinabuzachis]

@samccann The vmware.vmware_rest collection is also auto-generated using the https://github.com/ansible-community/ansible.content_builder. Also in this case, EXAMPLES blocks are populated using tasks coming from the integration tests.