>>40
Yes, when they're actually documented. The problem is that there seems to be a large number of developers who won't comment their code at all. They don't even use doc strings.

Grargh.

Save another developer's sanity: put in a useful comment for every class, method, and unusual paragraph of code.

# XX: fixme