documentation clarification per https://github.com/hmis-interop/xml/issues/13 .  Also, fix a broken reference to the correct section.