from Hacker News

Stop Commenting Your Code

by antonpug on 12/1/17, 6:34 PM with 17 comments

  • by saas_co_de on 12/1/17, 6:55 PM

    > Heavy code commenting is a symptom of bad code.

    I used to believe that comments were unnecessary for good code but eventually found this to be false.

    Now I do code annotation where every single line of code is commented.

    This allows the entire program to be read as plain english which is much faster and less mentally taxing than trying to read code.

  • by cgore on 12/1/17, 6:49 PM

    No.