I don't think that people give this situation enough credit. I once took over a project of about 30,000 lines of C++, with only about one line of commenting per 1,000 lines; and was frustrated with a lot of tools/documentation/suggestions that amounted to "don't write code like that". (Doxygen ended up being my friend)