Fix/improve version_added

[felixfontein]

Fix escaping and collection names in roles options, and make it say added in version 2.11 of ansible-core instead of added in version 2.11 of ansible.builtin.

Examples:

• https://ansible.fontein.de/collections/ansible/builtin/file_module.html#parameter-access_time
• https://ansible.fontein.de/collections/community/crypto/openssl_csr_module.html#parameter-attributes
• https://ansible.fontein.de/collections/felixfontein/acme/acme_certificate_role.html#parameter-main--acme_certificate_renewal_on_remaining_days

[briantist]

Looks good to me, for curiosity sake, do you happen have rendered output to see the differences?

[felixfontein]

Yes, see the above links :)

[felixfontein]

I wonder whether I should add special code to write ansible-base for 2.10 and Ansible for 2.9 and before. @briantist what do you think?

[briantist]

Yes, see the above links :)

🤦‍♂️ in my defense, I am not usually up this early

I wonder whether I should add special code to write ansible-base for 2.10 and Ansible for 2.9 and before. @briantist what do you think?

It seems you just pushed the commit. I was going to say "nah don't bother since they're EoL" but I realize now that the version added stuff will stay as long as those things haven't since been updated, so I think it's nice. And since it's already done, no need to remove it.

[felixfontein]

@briantist I also updated the built docs, so if you're happy I'll merge :)

[briantist]

Hm I have one possible English nit:

added in 0.5.0 of felixfontein.acme

To me it feels slightly unnatural, but it feels natural to say any of

added in version 0.5.0 of felixfontein.acme
added in v0.5.0 of felixfontein.acme
added in ver 0.5.0 of felixfontein.acme
added in felixfontein.acme version 0.5.0
added in felixfontein.acme v0.5.0
added in felixfontein.acme ver 0.5.0
added in felixfontein.acme 0.5.0

It's not a big enough thing for me to block over, and I'm also sensitive to screen real-estate for the text. Maybe get some other opinions on that.

[felixfontein]

How about added in felixfontein.acme 0.5.0? (Before it was writing added in 0.5.0 of, which definitely was much worse ;-) )

[felixfontein]

The docsite is now updated. See https://ansible.fontein.de/collections/community/crypto/crypto_info_module.html#ansible-collections-community-crypto-crypto-info-module for another example (module's version_added).

[felixfontein]

@briantist thanks for reviewing this!