-
Notifications
You must be signed in to change notification settings - Fork 4
📚 workflows: Improve help strings for input parameters
#19
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
base: main
Are you sure you want to change the base?
Conversation
mbercx
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks @ymzhang0! Looks great, just some minor nitpicks and a question if we should avoid adding some more technical details to the help for the inputs.
src/aiida_epw/workflows/prep.py
Outdated
| valid_type=(orm.RemoteData, orm.SinglefileData), | ||
| help=( | ||
| "A Julia script that converts the Wannier90 output files " | ||
| "(`prefix.chk`, `prefix.mmn`, ...) to the `epw.x` input format. This script is executed " |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we add the file suffix here? It's .ukk, no? (based on the input name ^^)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actually, for the latest version EPW>v6.0, not only .chk should be converted to .ukk, but also .mmn should be adapted a bit. So, I modified the .jl script for that. I tried to clarify this in the new commit. Maybe you can check if it's good.
src/aiida_epw/workflows/supercon.py
Outdated
| namespace_options={ | ||
| "help": "Inputs for the final isotropic `EpwBaseWorkChain`." | ||
| "help": ( | ||
| "Inputs for the final `EpwBaseWorkChain` that performs the `epw.x` calculation for the isotropic Migdal-Eliashberg equation. " |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hmm, strange that this passed the pre-commit. The line here is definitely too long. I think the default max line length should be 120 with Hatch.
clean up those `help` strings with unnecessarily technical information.
Update the help strings in
EpwBaseWorkChain,EpwPrepWorkChain,SuperConWorkChainto provide more detailed descriptions of the input parameters.