misc documentation fixes

@fosdev Please review and merge!
@fosdev Is this something that is actionable in this PR? Can we move forward with this PR?