I think one of the most useful places to write comments -- and one which I think is rarely done -- is # hack hack hack ! this function should really do XXX instead of YYY # that it does now That way, when you come across it later, you can be sure that this is code you meant to clean up and never got around to, rather than code that was done in this strange way on purpose. Laura