ansible-collections / community.hashi_vault

Ansible collection for managing and working with HashiCorp Vault.
https://docs.ansible.com/ansible/devel/collections/community/hashi_vault/index.html
GNU General Public License v3.0
81 stars 61 forks source link

consider adding "attributes" to collection content #197

Closed briantist closed 2 years ago

briantist commented 2 years ago
SUMMARY

Attributes show up in documentation, see: https://docs.ansible.com/ansible/latest/collections/ansible/builtin/include_role_module.html#attributes

Attribs: https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/doc_fragments/action_common_attributes.py#L11

Use in docs fragments will crash ansible-doc on older versions of Ansible 2.9/-base/-core.

For plugins, could crash Asnible itself on those older versions (unsure), however, attributes do not appear to be very useful in plugins as almost all of them apply only to modules/actions.

However, collection-specific attribs may be possible, and those would become useful in plugins too; we could define various attributes related to Vault functionality perhaps.

It seems there's little documentation on this for now.

ISSUE TYPE