phyloref / jphyloref

MIT License
0 stars 0 forks source link

Rearrange paper as per reviewer comment #91

Closed gaurav closed 3 years ago

gaurav commented 3 years ago

One of our reviewers suggested rearranging the paper a bit in their review. This PR is an attempt to do that.

You can see how this renders on Whedon.

I was hoping to edit the paper only after both reviewer comments were in, but I suppose we might as well start this discussion now.

hlapp commented 3 years ago

I don't think this is a useful rearrangement at all. Sacrificing a summary statement at the beginning, which gives readers the benefit of getting an overview before having to decide to read the full text, for a statement of need at the end, a place where by definition it can't help anyone better understand what was written (and what they needed to read) before, seems misguided.

I'll read through the manuscript one more time, but my hunch is that we may need to push back against the reviewer request. More specifically, if the issue is indeed not about whether a statement of need is present (which is the basic requirement set forth by JOSS) or lacking or insufficient, but primarily about whether a heading "Statement of Need" is present or not, which, in my reading, is not what is strictly required by JOSS, then I would argue we fulfill the requirement, and the additional request is not well justified.

That said, perhaps the fact that there is a statement of need already in the manuscript is not as obvious as it could be, and perhaps some small changes can be made to address that. That's I think the question that needs to be evaluated by re-reading with this in mind.

gaurav commented 3 years ago

Sounds good! Yes, I thought we might want to push back against the reviewer request, which is why I thought it would be best to do this once both reviews were in and it was time to write a response to the editor. I think the plan you outline sounds great.

hlapp commented 3 years ago

OK, how about you return this to draft stage then.

gaurav commented 3 years ago

Done!

ncellinese commented 3 years ago

Yes, I would wait for both reviews to be in. It would be better to see what he has to say if anything.

Nico

On Jul 14, 2021, at 10:31 AM, Gaurav Vaidya @.***> wrote:

Sounds good! Yes, I thought we might want to push back against the reviewer request, which is why I thought it would be best to do this once both reviews were in and it was time to write a response to the editor. I think the plan you outline sounds great.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/phyloref/jphyloref/pull/91#issuecomment-879943404, or unsubscribe https://github.com/notifications/unsubscribe-auth/AATJPQM4DO3IDPPP5UBKNZLTXWNS7ANCNFSM5AKWW2PQ.

gaurav commented 3 years ago

Superceded by PR #96, closing.