Merge pull request #428 from openjournals/issue-413

add details to reviewer guidelines (closes #413)
openjournals · Jul 24, 2018 · 1d2b868 · 1d2b868
2 parents 0de5664 + 96c095e
commit 1d2b868
Showing 1 changed file with 6 additions and 2 deletions.
diff --git a/docs/reviewer_guidelines.md b/docs/reviewer_guidelines.md
@@ -7,6 +7,10 @@ Firstly, thank you so much for agreeing to review for the Journal of Open Source
 
 We like to think of JOSS as a 'developer friendly' journal. That is, if the submitting authors have followed best practices (have documentation, tests, continuous integration, and a license) then their review should be rapid.
 
-For those authors that don't quite meet the bar, please try to give clear feedback on how they could improve their submission. A key goal of JOSS is to raise the quality of research software generally and you (the experienced reviewer) are well placed to give this feedback.
+For those submissions that don't quite meet the bar, please try to give clear feedback on how authors could improve their submission. A key goal of JOSS is to raise the quality of research software generally and you (the experienced reviewer) are well placed to give this feedback.
 
-We encourage reviewers to file issues against the submitted repository's issue tracker. Include in your review links to any new issues that you the reviewer believe to be impeding the acceptance of the repository. (If the submitted repository is a GitHub repository, mentioning the review issue URL in the submitted repository's issue tracker will create a mention in the review issue's history.)
+A JOSS review involves checking submissions against a checklist of essential software features and details in the submitted paper. 
+
+We encourage reviewers to file issues against the submitted repository's issue tracker. **When you have completed your review, please leave a comment in the review issue saying so.** 
+
+You can include in your review links to any new issues that you the reviewer believe to be impeding the acceptance of the repository. (Similarly, if the submitted repository is a GitHub repository, mentioning the review issue URL in the submitted repository's issue tracker will create a mention in the review issue's history.)