-
Notifications
You must be signed in to change notification settings - Fork 18
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
JOSS paper review #222
Comments
Hi @odow! Thanks for the rapid feedback, I agree with your comments, particularly that an immediate visual could help users understand the package, Here's a first list to address your comments.
In the paper:
Regarding the length, I've seen JOSS papers range from 1 paragraph to 6 pages, so I'm not sure if i necessarily agree that the length is extreme, but I know cutting can improve focus and conciseness. When you mention "shrinking", would you prefer less verbose language, or do you have specific pieces you feel readers would not miss being cut. |
I'd also move the statement of need to after the summary and before the "Features" section.
I don't know if I said extreme, but it's heading towards the upper end, especially if you add an example with a figure.
I thought lines 46-61 could be cut in favor of a sentence like "We also implement a number of features recently described in the literature to improve the robustness and flexibility of the ensemble algorithms (cites...)." But perhaps add the example etc, the see how the length is before cutting. |
Thanks for the update and clarification. We will start working on this soon. |
Hi @odow Thank you for your patience, our changes:
The latest paper.pdf |
Looks good. I wonder if it's still a little long, but I'll leave that to the editors if they complain. |
Hi all, I'm reviewing the JOSS paper: openjournals/joss-reviews#4869 (comment)
A couple of things jumped out at me, going off the JOSS checklist:
A statement of need The docs start with
and then it goes into academic literature review. I think you could start with a more generic statement of need that highlighted the derivative free optimization and its applicability for fitting parameters to expensive black-box simulation data.
Example usage The doc order could change. Currently, the examples are right at the bottom, and things like the contributing guide are higher. Provide a simple example as early as possible. Compare the BayesianOptimization intro examples: https://github.com/fmfn/BayesianOptimization#basic-tour-of-the-bayesian-optimization-package
State of the field you could briefly position EKP in the context of other Bayesian and DFO tools like BlackBoxOptim.jl and Python tools like BayesianOptimization (and presumably other EKP-like packages?)
The paper is also quite long. I'd be in favor of shrinking the "features" section in favor of a small code example that demonstrated the package.
Thoughts?
The text was updated successfully, but these errors were encountered: