[PR #1539/3551f199 backport][stable-2.17] docs/docsite/rst/dev_guide/developing_program_flow_modules.rst: avoid using aliases

ansible / ansible-documentation

Ansible community documentation

https://docs.ansible.com/

GNU General Public License v3.0

80 stars 467 forks source link

[PR #1539/3551f199 backport][stable-2.17] docs/docsite/rst/dev_guide/developing_program_flow_modules.rst: avoid using aliases #1660

Closed patchback[bot] closed 3 months ago

patchback[bot] commented 3 months ago

This is a backport of PR #1539 as merged into devel (3551f1999bb18fdfcd5ff2cbf85c33f42000be21).

As we're seeing newly developed collections submitted for inclusion contains multiple aliases, this PR adds a recommendation to avoid using them generally.

Justification:

Think well and choose the best name for the interface
Having many aliases can cause confusion among users