A review request asks someone to examine a document for particular problems and provide useful feedback. Make it specific: name the reviewer's focus, identify the intended reader when relevant, and avoid wording that pressures them to approve the draft. section 6.5.2
Use a review request to give feedback a clear target:
- Ask technical reviewers to check inadequate detail, factual errors, omissions, and irrelevant digressions. section 6.5.2
- Ask clarity reviewers to mark missing reader context, abrupt transitions, circular flow, and confusing sentences. section 6.5.2
- Put document-wide questions in the message and questions about particular passages in in-document comments. section 6.5.2
- Replace “How do you like it?” with an invitation to give candid, constructive criticism. section 6.5.2
A focused request
“Please check whether the target reader needs more context, whether any technical claims are inaccurate, and whether this code sample uses deprecated features.” section 6.5.2
