I agree that documentation is useful and important, but too much programming languages documentation really doesn't answer some fundamental questions about the semantics of a language.

All too often, this is because the programming language designers/implementors don't know what the semantics are.