Looks like that the answer for most is tools, or some new code convention. While that can be useful, the solution to facilitating code comprehension can only be

Looks like that the answer for most is tools, or some new code convention. While that can be useful, the solution to facilitating code comprehension can only be documentation. And to create documentation, the key component are not tools; people are. Technical writers, editors, and others.