Final tidying of PR comments: more docs, mostly