Code Smell 168 - Undocumented Decisions

TL;DR: Be declarative on your design or implementation decisions. Problems Code Comments Lack of testability Solutions Be Explicit about the reasons. Convert the comment to a method. Context Sometimes we find arbitrary rules not so easily te...