If it's too big a hurdle to read the manual you'll never manage to use it for its purpose. Is this a threat to you somehow? In what way?
Do you have the same opinion about ripgrep?
$ rg 'function('
regex parse error:
function(
^
error: unclosed groupAnd that’s what people say BeeBase should do here too.
Something like:
Error: invalid name: must start with uppercase letter
Not some obtuse message that you have to go look up in a manual for no reason
It worsens the UX for no reason.
As a sibling comment said, the program already knows why the name was invalid. It would have cost nothing to surface the reason when reporting the error.
Like knowledge of the regex language, or having spent ten minutes skimming through the tutorial part of a PDF manual.
In my experience, how to use a manual is a technique more widely understood than regex. Maybe this impression is wrong, I'd welcome something tangible pointing in another direction if it is.