New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[REVIEW]: Multivariate Covariance Generalized Linear Models in Python: The mcglm library #6037
Comments
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:
For example, to regenerate the paper pdf after making changes in the paper's md or bib files, type:
|
|
Wordcount for |
|
👋🏼 @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
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 #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. |
Review checklist for @bkrayfieldConflict of interest
Code of Conduct
General checks
Functionality
Documentation
Software paper
|
Review checklist for @SpaakConflict of interest
Code of Conduct
General checks
Functionality
Documentation
Software paper
|
@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 (jeancmaia/mcglm#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/ 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!" |
👋 @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? 👋 @Spaak and @bkrayfield - could you provide a short update to where you are in the review process? Thanks so much! |
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! |
Submitting author: @jeancmaia (Jean Carlos Maia)
Repository: https://github.com/jeancmaia/mcglm
Branch with paper.md (empty if default branch): main
Version: 0.2.1
Editor: @AJQuinn
Reviewers: @Spaak, @bkrayfield
Archive: Pending
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
The text was updated successfully, but these errors were encountered: