Throughout this year, we’ve published several posts about different aspects of the Staging Ground. This post will focus specifically on canned comments that Reviewers can provide on the question. We are hoping to gather feedback on what type of canned comments are required, and if we are using the right copy for each reason, as this has not been definitively decided.
Some of the previous posts can be found below:
- Staging Ground Workflow: Question Details & Actions
- Staging Ground Workflow: Listings, Filters, and Notifications
- Staging Ground Workflow: Question Lifecycle
Canned Comments
We are planning on implementing canned comments in order to help cut down on the time required to review a question, while also providing useful feedback to the Author.
Reviewers can compose their own comment or will be able to select from some pre-written canned responses to use as starting points for their feedback. Once selected, any canned responses will be editable. There is no requirement for Reviewers to use the canned comment if they would prefer not to.
While Reviewers can leave comments as part of any review, some Review Actions will require a comment. This was mentioned in a previous post.
- Approve pending Minor edits: The question looks good, but requires small changes to be made before it can be published. This moves the post to the Minor edits status. The UI will require that a comment be left by the Reviewer to explain what edits are needed) when selecting this Action (canned comments can be used here).
- Require Major changes: This action is for on-topic questions that require significant edits and reworking to improve question quality before they can be published, but are still salvageable. The UI will require that a comment be left by the Reviewer to explain what edits are needed when selecting this Action. Canned comments will be provided here for reviewers to choose from as a starting point for their comment.
Types of Canned Comments
One of the aims of the Staging Ground is to lower the closed question rate for questions by new authors. Authors can be coached to update their questions based on the feedback. Keeping that in mind, we’d like to make sure that the canned comments cover the common types of feedback and can be widely used.
The proposed canned comments below are inspired by the Question Close Reasons - Definitions and Guidance. Here are the canned comments that we have so far.
Comment Type | Description |
---|---|
Needs detail or clarity | The question doesn’t have enough detail or clarity to be answered. Please provide additional information such as examples, code, or any errors you’ve encountered to help others answer your question. |
Needs focus | This question is too broad or has multiple parts and it will be difficult to get a good answer. Try focusing on one aspect you’d like answered, or split this up into multiple questions. |
Needs debugging details | There isn’t enough information to reproduce the described issue. Update the question to include desired behavior, a specific problem or error, and the shortest code in an accessible format necessary to reproduce the problem. |
Custom | If none of these are the feedback you’d like to give, you can write your own. |
The Staging Ground is still under development, and these canned comments can change based on the feedback received from this post. Please let us know if we are missing anything, or if anything needs to be updated. If you have any questions or comments you’d like to share, please do so in an answer below.
[edit]
link shortcut. It will help people avoid using comments to clarify their questions.