Jay wrote:
"With exceptions of course, I'd submit that most code documentation beyond opcode sideline comments and routine headers are a waste of time".
I quoted:
"Professionals create beautiful code that is crystal clear"
Where is the difference ?

I am not arguing the volume of documentation, e.g. what is the purpose, except to irritate any thinking man, of a comment such as
push dph ;save data pointer high byte
whereas
mov a,pcount ; get dust particle count
may make life easier for someone.
The routine headers can (as seen most often) be utterly stupid, adhering to some meaningless standard and omitting the fact that this routine calculates the cosine of an angle less than 20 degrees stored in the acc with as angle*10