AFAICT, the addrPort and connectionRole annotation sections are not useful to end users; the only one that people care about as an independent entity is sslProfile
A lot of space is spent documenting deprecated attributes, often first, before the recommended ones; perhaps we should not document the deprecated ones at all, or move them to a dedicated section
The examples at the beginning use deprecated attribute syntax
The router section mixes important attributes (id, mode) with a bunch of tweakables; these are all presented as having equal importance; I recommend a wholly distinct location for all the low-level knobs that users should not have to care about