extended and rearranged documentation for no-warning-comments rule