openjournals / joss

The Journal of Open Source Software
https://joss.theoj.org
MIT License
1.54k stars 186 forks source link

[proposal] embed raised issues/PRs in paper page #1384

Open sneakers-the-rat opened 2 weeks ago

sneakers-the-rat commented 2 weeks ago

The opening instructions for reviews lightly encourage making comments in issues and pull requests, and I think those are often super valuable to authors, and a better way of tracking comments than in issue thread or in checklists.

Along with https://github.com/openjournals/joss/issues/1383 , I think we could improve the context of a work for our readers, give authors better feedback, and give reviewers more visible credit by making that a more official part of the review.

assuming it looks good and works well, what do yall think about

As before, I volunteer to implement this if we think its a good idea - and if I cant get a reasonably good impl then obvi we dont have to do it.

I think side benefit is that this also shows more of what joss reviews really look like if you havent followed the linkbacks from a review. The github interface actually makes it sort of hard to see all the linkbacks in a tidy way, so I and a few other reviewers I see just have to remember to list them all in our issue checklist to remember them all. Also good for editors for same reason.

danielskatz commented 2 weeks ago

Given that we have a variety of ways reviewers and authors communicate, and that this seems to be working to me, I don't see a reason to push actions in the software repo. Some reviewers are fine doing this, while others just want to leave comments in the review thread.

sneakers-the-rat commented 2 weeks ago

Im not saying they stop, but for those that do want to make their reviews more visible and provide context on what was discussed during the review to future readers, this would provide a means of doing that.