Skip to main content
10 events
when toggle format what by license comment
Feb 27, 2012 at 14:33 comment added vidstige "sometimes you need to explain what a complex bit of code is doing" - A hint from an experienced programmer: Your time is better spent simplifying that code.
Jan 8, 2011 at 15:12 comment added Jason Baker Comments only help you skim read if they're necessary. If they're not, they're wasted space.
Dec 30, 2010 at 23:10 comment added kirk.burleson @flamingpenguib - well said!
Dec 24, 2010 at 11:15 comment added flamingpenguin @orokuskai: good code is simple. The things it is doing may be complex but the simplicity (elegance) of the code is what makes it good in my opinion! Of course, code does lots of other things, and rubbish code can make you lots of money. But my goal is to write simple code even in complex situations.
Dec 24, 2010 at 11:13 comment added flamingpenguin @Jouke van der Mass: of course. But it does not matter how complex the algorithm, the goal is to express the algorithm simply. i.e. good code expresses complex algorithms, rules, optimisations, in a simple and unambigiously understandable way. Expressing simple things simply is comparatively easy. Expressing complex things simply is where the skill lies.
Sep 10, 2010 at 13:48 comment added DisgruntledGoat @orokusaki you are mistaking "good code doesn't need comments" with "simple code doesn't need comments". Good code isn't always simple.
Sep 10, 2010 at 0:27 history made wiki Post Made Community Wiki
Sep 9, 2010 at 20:19 comment added Jouke van der Maas @orokusaki Not every algorithm is that simple.
Sep 9, 2010 at 18:13 comment added orokusaki @DisgruntledGoad - It's true though. The misunderstanding in this "myth" comes from the fact that too many programmers consider their monolithic confusing code to be "good". if user.is_logged_in: print('Welcome') doesn't need a comment.
Sep 9, 2010 at 15:27 history answered DisgruntledGoat CC BY-SA 2.5