Closed editorialbot closed 4 months ago
Hello humans, I'm @editorialbot, a robot that can help you with some common editorial tasks.
For a list of things I can do to help you, just type:
@editorialbot commands
For example, to regenerate the paper pdf after making changes in the paper's md or bib files, type:
@editorialbot generate pdf
Software report:
github.com/AlDanial/cloc v 1.88 T=0.68 s (319.9 files/s, 27347.6 lines/s)
-------------------------------------------------------------------------------
Language files blank comment code
-------------------------------------------------------------------------------
Python 10 584 640 3674
CSS 4 36 12 1838
R 1 76 74 1515
Jupyter Notebook 4 0 7572 836
JavaScript 6 80 88 633
TeX 1 38 0 281
Markdown 2 48 0 222
JSON 184 0 0 184
YAML 2 6 4 41
TOML 1 5 0 25
make 1 4 7 9
reStructuredText 1 6 7 7
-------------------------------------------------------------------------------
SUM: 217 883 8404 9265
-------------------------------------------------------------------------------
gitinspector failed to run statistical information for the repository
Wordcount for paper.md
is 1744
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
OK DOIs
- 10.7287/PEERJ.PREPRINTS.1686V1 is OK
- 10.48550/arXiv.1809.10756 is OK
- 10.48550/arXiv.1810.09538 is OK
- 10.18637/jss.v076.i01 is OK
- 10.18637/jss.v084.i04 is OK
- 10.48550/arXiv.1409.7482 is OK
- 10.1111/j.2517-6161.1987.tb01685.x is OK
- 10.1002/1097-0258(20000730)19:14<1952::AID-SIM474>3.0.CO;2-K is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.2307/2344614 is OK
- 10.1007/978-3-642-21551-3_24 is OK
- 10.1214/ss/1177013604 is OK
- 10.1214/aos/1176345451 is OK
- 10.1002/9781118445112.stat07536 is OK
- 10.2307/2841583 is OK
- 10.2307/2333849 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41592-019-0686-2 is OK
- 10.18637/jss.v084.i04 is OK
- 10.25080/Majora-92bf1922-011 is OK
- 10.1177/0962280212445834 is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.1093/biomet/73.1.13 is OK
- 10.1111/rssc.12145 is OK
- 10.1515/ijb-2017-0001 is OK
MISSING DOIs
- None
INVALID DOIs
- None
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
👋🏼 @jeancmaia @spaak @bkrayfield this is the review thread for the paper. All of our communications will happen here from now on.
For @spaak and @bkrayfield - As a reviewer, the first step is to create a checklist for your review by entering
@editorialbot generate my checklist
as the top of a new comment in this thread. Please can you do this soon as a confirmation that you've seen the review starting.
These checklists contain the JOSS requirements. As you go over the submission, please check any items that you feel have been satisfied. The first comment in this thread also contains links to the JOSS reviewer guidelines.
The JOSS review is different from most other journals. Our goal is to work with the authors to help them meet our criteria instead of merely passing judgment on the submission. As such, the reviewers are encouraged to submit issues and pull requests on the software repository. Summary conversation is great on this thread but try to avoid substantial discussion about the repository here, this should take place in issues on the source repository.
When discussing the submission on an issue thread, please mention openjournals/joss-reviews#6037 so that a link is created to this thread (and I can keep an eye on what is happening). Please also feel free to comment and ask questions on this thread. In my experience, it is better to post comments/questions/suggestions as you come across them instead of waiting until you've reviewed the entire package.
We aim for reviews to be completed within about 2-4 weeks. Please let me know if any of you require some more time. We can also use EditorialBot (our bot) to set automatic reminders if you know you'll be away for a known period of time.
Please feel free to ping me (@AJQuinn) if you have any questions/concerns.
@jeancmaia As for API docs: some more details could be added. power_fixed/maxiter/tol/tuning/weights are all underspecified. (I can imagine some things they do in the optimization step, but better to make this explicit, e.g. by briefly explaining the type of optimization done here.) Also Ntrial has a capital N (against common style).
@jeancmaia I appreciate the extensive tutorial (https://github.com/jeancmaia/mcglm/issues/7) but that appears to be the only web presence besides the PyPI install page (and github). I'd recommend at least making sure there is a hosted version of the API docs available somewhere.
Also there are no community guidelines (see review checklist item) anywhere, I'd recommend adding these to either wherever you end up putting the web API docs or (and) simply in README.md on github.
@jeancmaia I'd recommend going over the paper a final time for a thorough language check. While it's clearly written, there are some minor issues that should be (easy to) fix(ed).
@Spaak Thanks for the comprehensive feedback. I have revamped the project by incorporating all the aforementioned items.
The new API Docs is hosted on: https://mcglm.readthedocs.io/en/latest/ The new paper is available on: https://github.com/jeancmaia/mcglm/blob/main/paper.md
It would be great if you could check the project out again. Thanks :)
Thanks @Spaak for the review and to @jeancmaia for the quick response.
@bkrayfield - thanks for your work so far, do you have a sense when you'd be able to complete the review/checklist? Let me know if you need any additional input.
Hey @AJQuinn, I hope you're doing well. Just to catch up. I wanted to check in to see if there's anything else you need from me to move forward with the article review. Thank you for your time!"
:wave: @jeancmaia - I am the AEiC for this track of submissions and I can help out a bit here. I looks like there are still a few open pull requests. Can you provide some feedback on the status of those here in this thread?
:wave: @Spaak and @bkrayfield - could you provide a short update to where you are in the review process?
Thanks so much!
Hey @crvernon. I have addressed all the great feedback provided by @Spaak and refactored both the library and the paper.
Thanks!
Thanks @jeancmaia!
Hello @crvernon, end of semester work has slowed me down, but making progress. Should be rounding everything up this week.
@crvernon The only remaining feedback I have is that the tutorial and paper could contain a little bit more motivating background on why an inference with an MCGLM model is more powerful (in some sense) than something univariate/classical. But I think that is also a matter of preference (related to the journal and its scope); the software itself is adequately documented. All other points have been taken care of!
Thanks to you both @bkrayfield and @Spaak.
:wave: @bkrayfield - I noticed that you still have a few items to check off on your list. Could you provide an estimate of when you will be able to provide feedback on these items?
Thanks!
@editorialbot assign me as editor
Assigned! @crvernon is now the editor
:wave: @bkrayfield - Just following up...
Thanks to you both @bkrayfield and @Spaak.
👋 @bkrayfield - I noticed that you still have a few items to check off on your list. Could you provide an estimate of when you will be able to provide feedback on these items?
Thanks!
@crvernon Thank you for the mention. I am actively working on getting the other items completed. Given it's interplay with other work on my plate, I can give you an estimate of June 23rd to wrap everything up.
@bkrayfield thanks for the update!
@crvernon After reviewing the issues raised by @Spaak and the repo, I was able to check every item off the checklist. I did want to refer back to the community guidelines point of @Spaak. I was able to find them in the docs, but I would recommend taking them out as a separate point and adding a little more detail (more on the type of pull requests the maintainer is looking for, etc...).
@editorialbot generate pdf
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
@editorialbot check references
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
OK DOIs
- 10.7287/PEERJ.PREPRINTS.1686V1 is OK
- 10.48550/arXiv.1809.10756 is OK
- 10.48550/arXiv.1810.09538 is OK
- 10.18637/jss.v076.i01 is OK
- 10.18637/jss.v084.i04 is OK
- 10.48550/arXiv.1409.7482 is OK
- 10.1111/j.2517-6161.1987.tb01685.x is OK
- 10.1002/1097-0258(20000730)19:14<1952::AID-SIM474>3.0.CO;2-K is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.2307/2344614 is OK
- 10.1007/978-3-642-21551-3_24 is OK
- 10.1214/ss/1177013604 is OK
- 10.1214/aos/1176345451 is OK
- 10.1002/9781118445112.stat07536 is OK
- 10.2307/2841583 is OK
- 10.2307/2333849 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41592-019-0686-2 is OK
- 10.18637/jss.v084.i04 is OK
- 10.25080/Majora-92bf1922-011 is OK
- 10.1177/0962280212445834 is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.1093/biomet/73.1.13 is OK
- 10.1111/rssc.12145 is OK
- 10.1515/ijb-2017-0001 is OK
MISSING DOIs
- No DOI given, and none found for title: SOLID Principles in Software Architecture and Intr...
INVALID DOIs
- None
Thanks @bkrayfield and @Spaak! It looks like your checklists are completed now.
:wave: @jeancmaia I'll take a look now and see if we can get this moving towards publication.
General:
In the paper:
Thanks!
@editorialbot generate pdf
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
@editorialbot check references
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
OK DOIs
- 10.7287/PEERJ.PREPRINTS.1686V1 is OK
- 10.48550/arXiv.1809.10756 is OK
- 10.48550/arXiv.1810.09538 is OK
- 10.18637/jss.v076.i01 is OK
- 10.18637/jss.v084.i04 is OK
- 10.48550/arXiv.1409.7482 is OK
- 10.1111/j.2517-6161.1987.tb01685.x is OK
- 10.1002/1097-0258(20000730)19:14<1952::AID-SIM474>3.0.CO;2-K is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.2307/2344614 is OK
- 10.1007/978-3-642-21551-3_24 is OK
- 10.1214/ss/1177013604 is OK
- 10.1214/aos/1176345451 is OK
- 10.1002/9781118445112.stat07536 is OK
- 10.2307/2841583 is OK
- 10.2307/2333849 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41592-019-0686-2 is OK
- 10.18637/jss.v084.i04 is OK
- 10.25080/Majora-92bf1922-011 is OK
- 10.3844/jcssp.2021.624.638 is OK
- 10.1177/0962280212445834 is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.1093/biomet/73.1.13 is OK
- 10.1111/rssc.12145 is OK
- 10.1515/ijb-2017-0001 is OK
MISSING DOIs
- None
INVALID DOIs
- None
Hi, @crvernon. Thanks for your feedback. I have thoroughly addressed all items from your list and solved a missing DOI.
👋 @jeancmaia - we are almost there! Next is just setting up the archive for your new release.
We want to make sure the archival has the correct metadata that JOSS requires. This includes a title that matches the paper title and a correct author list.
So here is what we have left to do:
[x] Conduct a GitHub release of the current reviewed version of the software and archive the reviewed software in Zenodo or a similar service (e.g., figshare, an institutional repository). Please ensure that the software archive uses the same license as the license you have posted on GitHub.
[x] Check the archival deposit (e.g., in Zenodo) to ensure it has the correct metadata. This includes the title (should match the paper title) and author list (make sure the list is correct and people who only made a small fix are not on it). You may also add the authors' ORCID.
[x] Please respond with the DOI of the archived version and the version number of the release here
I can then move forward with accepting the submission.
Hi @crvernon. Thanks for helping me throughout this process.
I released a software version named "v0.2.4" and published it at Zenodo. All metadata match appropriately.
Archived version's DOI is: 10.5281/zenodo.12569049
Thank you very much!
Thanks @jeancmaia! A couple of simple things that need to be adjusted:
Thanks!
Thanks @crvernon. Sorry for those minor bugs. Both versions of Zenodo and the library match now; check out those urls: https://zenodo.org/records/12569050, https://github.com/jeancmaia/mcglm/tree/v0.2.4, https://pypi.org/project/mcglm/. Also, authors were rearranged correctly. Can you check it out again? Thanks!
@editorialbot set v0.2.4 as version
Done! version is now v0.2.4
@editorialbot set 10.5281/zenodo.12569050 as archive
Done! archive is now 10.5281/zenodo.12569050
@editorialbot recommend-accept
Attempting dry run of processing paper acceptance...
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
OK DOIs
- 10.7287/PEERJ.PREPRINTS.1686V1 is OK
- 10.48550/arXiv.1809.10756 is OK
- 10.48550/arXiv.1810.09538 is OK
- 10.18637/jss.v076.i01 is OK
- 10.18637/jss.v084.i04 is OK
- 10.48550/arXiv.1409.7482 is OK
- 10.1111/j.2517-6161.1987.tb01685.x is OK
- 10.1002/1097-0258(20000730)19:14<1952::AID-SIM474>3.0.CO;2-K is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.2307/2344614 is OK
- 10.1007/978-3-642-21551-3_24 is OK
- 10.1214/ss/1177013604 is OK
- 10.1214/aos/1176345451 is OK
- 10.1002/9781118445112.stat07536 is OK
- 10.2307/2841583 is OK
- 10.2307/2333849 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41586-020-2649-2 is OK
- 10.1038/s41592-019-0686-2 is OK
- 10.18637/jss.v084.i04 is OK
- 10.25080/Majora-92bf1922-011 is OK
- 10.3844/jcssp.2021.624.638 is OK
- 10.1177/0962280212445834 is OK
- 10.1214/12-EJS721 is OK
- 10.1016/j.jmva.2013.05.001 is OK
- 10.1093/biomet/73.1.13 is OK
- 10.1111/rssc.12145 is OK
- 10.1515/ijb-2017-0001 is OK
MISSING DOIs
- None
INVALID DOIs
- None
:warning: Error preparing paper acceptance. The generated XML metadata file is invalid.
ID tabU003Amethods already defined
ID ref-BonatU003A2018 already defined
ID ref-MasarottoU003A2012 already defined
ID ref-KrupskiiU003A2013 already defined
I have found duplicated refs on the paper.bib. Solved.
@editorialbot recommend-accept
Submitting author: !--author-handle-->@jeancmaia<!--end-author-handle-- (Jean Carlos Maia) Repository: https://github.com/jeancmaia/mcglm Branch with paper.md (empty if default branch): main Version: v0.2.4 Editor: !--editor-->@crvernon<!--end-editor-- Reviewers: @Spaak, @bkrayfield Archive: 10.5281/zenodo.12569050
Status
Status badge code:
Reviewers and authors:
Please avoid lengthy details of difficulties in the review thread. Instead, please create a new issue in the target repository and link to those issues (especially acceptance-blockers) by leaving comments in the review thread below. (For completists: if the target issue tracker is also on GitHub, linking the review thread in the issue or vice versa will create corresponding breadcrumb trails in the link target.)
Reviewer instructions & questions
@Spaak & @bkrayfield, your review will be checklist based. Each of you will have a separate checklist that you should update when carrying out your review. First of all you need to run this command in a separate comment to create the checklist:
The reviewer guidelines are available here: https://joss.readthedocs.io/en/latest/reviewer_guidelines.html. Any questions/concerns please let @AJQuinn know.
✨ Please start on your review when you are able, and be sure to complete your review in the next six weeks, at the very latest ✨
Checklists
📝 Checklist for @bkrayfield
📝 Checklist for @Spaak