The style of error and warning messages is a bit all over the place right now. We should standardize them and document what is required.
An arbitrary suggestion (I’m fine with anything, really):
- Start with capital letter
- No fullstop at the end
Thus we say “Weights must be non-negative”, and not “weights must be non-negative” or “Weights must be non-negative.”
It’s not a huge deal but I’m always frustrated about not knowing what style to use when writing messages.
If we write guidelines for errors/warnings, here’s another suggestion: Provide context when possible and make the message as specific as possible. Thus, we say “Weights must be non-negative” and not “Invalid weight vector”. The former states why it is invalid.