> To assume "at the code level it should be largely self-documenting" is to be a Rick

You don't have to be a Rick to write clean, concise code.

I'd strongly recommend reading up:

http://www.codeodor.com/index.cfm/2008/6/18/Common-Excuses-U...

https://blog.codinghorror.com/coding-without-comments/