The most egregious thing for me is: > in other words, the reader is expected to understand the semantics of an unknown function without consulting the declarat

The most egregious thing for me is: > in other words, the reader is expected to understand the semantics of an unknown function without consulting the declaration (or documentation). The idea that the author considers making code as self-documenting as possible at the call site a conceptual mistake is just weird to me.