Limiting Code Comments Increases Maintainability
Posted by: Jeffrey Palermo,
on 16 Jan 2009 |
View original | Bookmarked: 0 time(s)
The assertion of this post is that code comments are a smell. Creating obvious, readable code is more maintainable that unreadable code that is heavily commented. Matt Hinze is teaching Agile Boot Camp, part 1 this week, and one of his lessons is about code readability. He spoke about code comments being a smell. When something smells, it doesn't guarantee that it is rotten, but it does create the need to examine more closely to see if any bacteria is beginning to invade the codebase. ...