as part of 14525 I have a PR required on illumos-docbooks, if someone could take a look would great, as is my first time modifying the docs.