misc documentation fixes

@fosdev Please review and merge!