added comment about code design