Documentation spring cleanup (either three months early or nine months late, it's up to you)

[miodvallat]

Short description

I couldn't help but notice a few bits which could be improved while reading the docs. This PR is an attempt at improvement. Features:

• Some layout/rendering changes to hopefully make things more readable (especially option lists, which sometimes were not rendered as bullet lists).
• URL updates, especially for those which are now 404.
• Mention RFC9077 rather than saying "we're not conforming to RFC4034 because there's a bug in it".
• Many master/slave -> primary/secondary changes, but not everywhere, especially not in the BIND backend because I'm not sure BIND has changed its terminology and I don't want to introduce more confusion than necessary.
• Random typo fixes, grammar fixes, sorting fixes.

Checklist

I have:

• read the CONTRIBUTING.md document
• compiled this code
• tested this code
• included documentation (including possible behaviour changes)
• documented the code
• added or modified regression test(s)
• added or modified unit test(s)

[coveralls]

Pull Request Test Coverage Report for Build 12348495783

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• 75 unchanged lines in 12 files lost coverage.
• Overall coverage decreased (-0.03%) to 64.751%

---

Files with Coverage Reduction	New Missed Lines	%
pdns/pollmplexer.cc	1	83.66%
pdns/misc.cc	2	64.68%
pdns/iputils.cc	3	55.91%
pdns/tsigverifier.cc	3	77.22%
pdns/recursordist/syncres.cc	3	79.49%
pdns/recursordist/rec-main.cc	3	62.35%
pdns/recursordist/rec-tcpout.cc	6	50.79%
pdns/recursordist/test-syncres_cc1.cc	8	89.18%
pdns/dnsdistdist/dnsdist-tcp.cc	8	75.79%
pdns/recursordist/ext/luawrapper/include/LuaContext.hpp	8	14.17%

Totals
Change from base Build 12316427950:	-0.03%
Covered Lines:	125883
Relevant Lines:	163535

---

💛 - Coveralls

[miodvallat]

Marking as draft as more changes are coming, no need to spend too much time on reviewing this yet.

[Habbie]

• especially not in the BIND backend because I'm not sure BIND has changed its terminology

they have!

[miodvallat]

• especially not in the BIND backend because I'm not sure BIND has changed its terminology

they have!

Well then, expect a secondary follow-up PR later this month after this one is being taken care of.

[Habbie]

Wonderful! I did not check every line, but I have confidence :)

[miodvallat]

Wonderful! I did not check every line, but I have confidence :)

Did you at least check the RFC9077 changes to confirm I did not write too many wrong things there?

[Habbie]

Did you at least check the RFC9077 changes to confirm I did not write too many wrong things there?

Looks good to me!