Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
Docs formatting: recursively preprocess suboptions #61900
Right now, suboptions are not processed (i.e. sorted by keys, description massaged,
Sep 6, 2019
Just adding some tidbits:
Similar to the above comment, the suboptions disappear with this PR.
Sep 12, 2019
1 check passed
@acozine suboptions were already supported before; this PR only changes that they are properly preprocessed (i.e. description is converted to a list if it is just a string, some error messages are displayed in some cases, too old
@acozine for which versions should I create backports? stable-2.9 definitely. But also for stable-2.8?
And something else: on https://docs.ansible.com/ansible/devel/modules/ios_l2_interfaces_module.html#parameters and here that it is now possible to document element types for lists. This has been added in #59244 apparently. I guess this is included in stable-2.9; has this been backported to stable-2.8, or are there plans for that? In any case, it would be good if more people knew about this, as it really improves documentation :)