Add documentation for how to use or add attributes

[samccann]

Summary

How to use them, how to add them to existing or new plugins etc.

Issue Type

Documentation Report

Component Name

docs/docsite/rst/dev_guide/index.rst

Ansible Version

$ ansible --version
2.15

Configuration

# if using a version older than ansible-core 2.12 you should omit the '-t all'
$ ansible-config dump --only-changed -t all
none

OS / Environment

none

Additional Information

none

Code of Conduct

• I agree to follow the Ansible Code of Conduct

[samccann]

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

and https://github.com/ansible/ansible/blob/devel/lib/ansible/modules/include_role.py

[samccann]

note from meeting - Attributes are NOT limited to existing ones, they can be used by authors to define/note quirks about their plugins that create/dont follow diff norms

[samccann]

See ansible-collections/community.hashi_vault#325 for an example of the details that need to be documented.

[larryease]

@samccann , could you give a clearer description of this project? Thanks.

[AbdouMechraoui]

How could one use the action attribute with assert that. Does this mean assert that can call Roles or action modules to be executed before failing?