Comment by son_of_gloin

Literate Programming would also probably help coding assistants understand the code better and generate better output. Or is that the point you are trying to make?