Some feedback from having done a review of a pyOpenSci package.
- It wasn’t clear whether comments should be inline with each review topic or just at the end. I found it easier to note comments inline, and have any additional comments at the end.
- There’s a slight formatting issue when I copied the raw Markdown from the template to the editor that I used (Simplenote) and then back again, where the check boxes changed formatting. This might be how my editor handles Markdown.
- It might make sense to put the JOSS requirements after the functionality requirements
- There was some repetition about packaging guidelines and other categories
In terms of accessing the reviewing template and instructions, I didn’t have any particular issues. However I think it would be good if links to the reviewing instructions and templates were included in the GitHub comment (and thus the email notification) which asks the reviewer to do the review.