Comment

Comment on New Study: 54% of American Adults Read Below 6th Grade-Levels

ChickenLadyLovesLife@lemmy.world ⁨1⁩ ⁨year⁩ ago

There’s a weird ongoing thing in the programming world where about half of coders think code should be well-commented and the other half not only think that code shouldn’t contain comments but also think that comments are an indicator of professional incompetence (aka a “code smell”). I’ve long noticed that the anti-commenting crowd are also the ones that can’t write very well.

source

Sort:hotnew top

Jax@sh.itjust.works ⁨1⁩ ⁨year⁩ ago
Almost like they don’t want anyone to figure out how dogshit their code is.

source
- Gabu@lemmy.world ⁨1⁩ ⁨year⁩ ago
  People who dislike code documentation are often overoptimizers, from my experience.
  
  source
  - afraid_of_zombies@lemmy.world ⁨1⁩ ⁨year⁩ ago
    In my experience it is job security.
    
    source
  - DarthBueller@lemmy.world ⁨1⁩ ⁨year⁩ ago
    Optimizing like it’s the early 80s and every byte is precious? Or do you mean something else?
    
    source
    Gabu@lemmy.world ⁨1⁩ ⁨year⁩ ago
    Exactly. Using 10 obscure instructions to save 1 clock cycle.
    
    source
    -> View More Comments
kicksystem@lemmy.world ⁨1⁩ ⁨year⁩ ago
One way my code improves is by thinking what I need to comment. Then I refactor some and the comments become somewhat redundant.

source
afraid_of_zombies@lemmy.world ⁨1⁩ ⁨year⁩ ago
I don’t think I would agree to work with someone who doesn’t comment their code.

source
- ChickenLadyLovesLife@lemmy.world ⁨1⁩ ⁨year⁩ ago
  I was basically driven out of my last job by someone who wouldn’t agree to work with someone (me) who did comment their code. Like I said, it’s a really weird dividing line in programming.
  
  source
  - afraid_of_zombies@lemmy.world ⁨1⁩ ⁨year⁩ ago
    I am sorry that happened to you but it sounds like it was for the best. I work at a place where knowledge sharing is pushed for. Everyone shares what they know. It makes things so much easier even if we do “waste” time cross training.
    
    My last job was me replacing the inhouse developer, I got it by demonstrating on the interview that I could reverse engineer his code. The versions he had put into production had all the comments stripped out and he had replaced every variable with random alphanumeric sequences about 8 characters long.
    
    Shouldn’t have known right there and then what kinda workplace I was dealing with.
    
    source