Use semantic markup

[felixfontein]

SUMMARY

Depends on ansible/ansible#74937 and ansible-community/antsibull-build#281 ansible-community/antsibull-docs#4.

The result can be seen here:

• https://ansible.fontein.de/collections/community/dns/hosttech_dns_records_module.html#synopsis for O(ignore=true) in RST;
• https://ansible.fontein.de/collections/community/dns/hosttech_dns_record_info_module.html#return-sets for O(what=single_record) in HTML;
• https://ansible.fontein.de/collections/community/dns/hosttech_dns_records_module.html#parameter-records/prefix for simple O() and V() usages;
• https://ansible.fontein.de/collections/community/general/dependent_lookup.html#parameter-_raw for P(ansible.builtin.dict2items#filter) in HTML;

ISSUE TYPE

• Docs Pull Request

COMPONENT NAME

extra docs

[codecov]

Codecov Report

Merging #23 (87f0217) into main (d4ab04f) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main      #23   +/-   ##
=======================================
  Coverage   96.43%   96.43%           
=======================================
  Files          91       91           
  Lines        6373     6373           
  Branches      758      758           
=======================================
  Hits         6146     6146           
  Misses        163      163           
  Partials       64       64           

Flag	Coverage Δ
integration	36.21% <ø> (ø)
sanity	31.13% <ø> (ø)
units	95.79% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
plugins/doc_fragments/filters.py	100.00% <ø> (ø)
plugins/doc_fragments/hetzner.py	100.00% <ø> (ø)
plugins/doc_fragments/hosttech.py	100.00% <ø> (ø)
plugins/doc_fragments/inventory_records.py	100.00% <ø> (ø)
plugins/doc_fragments/module_record.py	100.00% <ø> (ø)
plugins/doc_fragments/module_record_info.py	100.00% <ø> (ø)
plugins/doc_fragments/module_record_set.py	100.00% <ø> (ø)
plugins/doc_fragments/module_record_set_info.py	100.00% <ø> (ø)
plugins/doc_fragments/module_record_sets.py	100.00% <ø> (ø)
plugins/doc_fragments/module_zone_info.py	100.00% <ø> (ø)
... and 10 more

[felixfontein]

The failing sanity tests are due to a bug in ansible-test in stable-2.10 (ansible/ansible#75272) and potentially also 2.9.

[felixfontein]

CI should pass once ansible/ansible#75405 is merged.

[felixfontein]

recheck

[felixfontein]

I rebased since antsibull-docs now supports semantic markup out of the box.

[felixfontein]

I rebased again to remove the usage of my ansible-core branch since the associated PR has been merged 🎉

So the only thing this PR is waiting for is a review (at least by myself, to see whether I actually caught all markup to convert, and did it correctly), and that the last Ansible 7 release is out so that the Ansible 7 docsite (which doesn't understand semantic markup) for this collection won't be defaced.

[felixfontein]

Ansible 8.0.0 will be released on 2023-06-06 or 2023-05-30 (see https://docs.ansible.com/ansible/devel/roadmap/COLLECTIONS_8.html#release-schedule), so the last Ansible 7.x.y release should be on 2023-06-21. Which means we can finally merge and release this around 2023-06-22 🎉