{"format":"mailschema-contribution/1","id":"example-review-question","kind":"amendment","contributor":{"name":"Example Document Service","url":"https://example.com"},"baseDigest":"a48411f3372e87f3a5fc74725a9ad85f86dee0cea0b747a96338084c4f1fdd04","summary":"Ask how withdrawn drafts affect pending reviews.","record":{"slug":"content-review","name":"Content Review","summary":"Request changes or approve a specific revision of content.","category":"Review","status":"Draft","version":"0.1","profile":"Email + authenticated HTTPS (draft)","overview":"A service sends content for review. The recipient can submit feedback or record approval of the revision they received. Editing the draft and sending or publishing it remain separate service operations.","target":"Service-owned content identified by its exact revision.","operations":[{"name":"Request changes","description":"Record feedback on the identified revision."},{"name":"Approve","description":"Record approval of that revision."}],"inputs":"The target revision and, for a change request, review feedback.","results":"Feedback recorded or approval recorded, with the revision identified. Requests without permission or against stale revisions leave the current review decision unchanged.","permissions":"The service checks the caller’s review permission. Editing and any later sending or publication require their own permissions.","humanRoute":"A review page showing the same content and revision.","example":{"title":"Review a campaign draft","steps":["The service emails a review request for revision 3 of a campaign.","A reviewer asks for a timezone to be added to the opening paragraph.","The service records the feedback. An editor prepares revision 4.","The reviewer approves revision 4 and the service records that decision."],"exception":"An approval request for revision 3 is refused once that revision is stale. Approval of revision 4 does not send the campaign."},"references":[{"title":"Schema.org Actions","href":"https://schema.org/docs/actions.html","description":"Candidate vocabulary for describing available operations and their routes."},{"title":"Schema.org ReviewAction","href":"https://schema.org/ReviewAction","description":"Describes an opinion about an object. It is not equivalent to the revision approval in Content Review."}],"openQuestions":["Wire representation and operation identifiers.","Revision references and retry behaviour.","How does withdrawing a draft affect a pending review?"],"definition":{"label":"Read the Content Review definition","href":"/specification/content-review/"},"maintainers":[{"name":"MailSchema"}]}}