@simon The idea that code can serve as documentation is more a rebuttal to what's taught in school i.e. add a comment before every line. I need a comment before every line in class because I want to know if the student understands.

The problem with inline documentation outside of class is that it can become out of step with the code, the goal of saying the code is the documentation is to have programmers write clear, rather than clever code.