I absolutely hate it when people say "I don't ever add comments because my code is well written and speaks for itself"

No you conceited dickheaded knobgobbler you add comments so I don't have to read thoroughly through all your fucking obscurely named functions to know what the fuck "VToMap" is supposed to do.

  • 7
    VToMap does V TO MAP. Ha! Simple as that.
  • 2
    Joke apart, I agree with you. Comments should be there. In every code. No excuse.
  • 4
    I would comment on vtomap. But i hate seeing unnecessery comments
  • 5
    There should be comments but they should answer question 'why' instead of 'what'.
  • 2
    There 2 ends of the story stupid comments on methods like getters which say “gets the name” are just polution. And no comments at all is just a middlefinger to the next developer who touches that code.

    I believe that eveything in your code schould have a purpose. So comments should have a purpose to clarify business logic or explain complex parts.
  • 2
    I usually do obnoxiously long and descriptive names instead of comments. A standard thing could be:

    (defn concatentate-and-prefix-strings [arg & rest]
    (str *prefix* arg (string/join rest " "))

    Small functions with obvious names and obvious code is much better than commenting everything
  • 0
    Also, commenting helps you as the author yourself. If you can't comment your code well, you can't talk about your code and you are probably not implementing a well articulated design.
    Maybe one should even write a few comments before writing the first function?
  • -1
    First time i have no idea where is sync setting,but is not difficult,here the all possible solution,so click here this site http://syncsettingswindows10.com first open the start button and click the setting>account and finally click the sync your setting.
  • -1
    Very exciting post
Your Job Suck?
Get a Better Job
Add Comment