misc documentation fixes

@fosdev Please review and merge!
Is the suggested test being added to this document or another document?