"Read the docs" is not an excuse for incomprehensible source code. If links to documentation are not in the code, they might as well be nonexistent.
In this case, I've never read the sources, so I have no idea if the complaint is valid.
In this case, I've never read the sources, so I have no idea if the complaint is valid.
Yeesh. I must either be getting old, or everyone is significantly more busy than I am. I find that I always have time to at least locate any official documentation for the thing that I'm working with.