Documentation of parameter pc_member in module cisco.aci.aci_interface_config (DCNE-309)

[velotiger]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment

Description

documentation

• Description of parameter «pc_member» is misleading.

Affected Module Name(s):

• aci_interface_config

APIC version and APIC Platform

• V 5.2(8i) and on-prem.

Collection versions

• cisco.aci 2.10.1

Output/ Error message

• Command: ansible-doc cisco.aci.aci_interface_config
• Output:

   pc_member  The name of the Port Channel Member.
        aliases: [port_channel_member]
        default: null
        type: str

Expected Behavior

• Output should be something like:

   pc_member  The name of the Port Channel Member Policy (e.g. Fast LACP policy)
        aliases: [port_channel_member]
        default: null
        type: str

• IMHO an example task using this parameter (e.g. for a policy that defines Fast LACP) would be very helpful.
• An explicit statement that you set the Port Channel Member Policy here (one place) and not as before in the Policy Group and for all Member Interfaces like before (very cumbersome, 200305-Configure-Fast-LACP-Timer-in-ACI.pdf) would be very helpful, too.

Actual Behavior

• Not applicable.

Playbook tasks to Reproduce

• Not applicable.

Important Factoids

No functional error, module works as expected.

References

• Online documentation cisco.aci.aci_interface_config, parameter: pc_member

[akinross]

Hi @velotiger,

Thank you for raising this issue, I have added it to the to our backlog. Since it is working as expected I have removed the bug label you attached and assigned it enhancement and documentation.