That particular comment seems OK. In general, one should make the code readable to the point of not needing a comment. Comments can rot over time in legacy syst

That particular comment seems OK. In general, one should make the code readable to the point of not needing a comment. Comments can rot over time in legacy systems. Somethings really benefit from a comment, however I feel the following snippet is a better example of a comment that should not exist as it does not serve to clarify the code and is just a direct English translation of the simple code: # Iterate through article's sections for section in self.page.sections: