2 ms·

This is not a case of "code for people to read". If you want that, maybe try literate programming[0]. I prefer in the case where the code is blindingly fucking

This is not a case of "code for people to read". If you want that, maybe try literate programming[0]. I prefer in the case where the code is blindingly fucking obvious for there not to be an extra comment above it that adds no value whatsoever. I much prefer for comments to be about the theory of the code rather than to explain in a worse way what I can already clearly see simply by reading the code. In other words I much prefer comments about, say, why some particular data structure was chosen, over comments that only say shit like "create a new linked list". [0]: https://en.wikipedia.org/wiki/Literate_programming https://en.wikipedia.org/wiki/Literate_programming

soulofmischief 2y ago
How about we don't tell other people how to code? It's one thing to make suggestions, it's another to make demands. I've been doing this for a long time and I can code laps around most people. I also like well-commented code that allows me to quickly skim code and check it for correctness. You can have your preferences all you want and that's great, but when you start passing irrational judgement about the value of someone's code just because it's liberally commented, your perspective becomes less respectable.
- LoganDark 2y ago
  > How about we don't tell other people how to code? It's one thing to make suggestions, it's another to make demands. I've been doing this for a long time and I can code laps around most people. I also like well-commented code that allows me to quickly skim code and check it for correctness. I'm sorry, that was not intended to be received as a demand, I edited my comment to hopefully clarify. > You can have your preferences all you want and that's great, but when you start passing irrational judgement about the value of someone's code just because it's liberally commented, your perspective becomes less respectable. I didn't say anything about the value of your or anyone's code other than that obvious comments don't add any to me. (I do tend to find it funny when a comment manages to obviously contradict the code that it's about, but here that's not the case.) My point was more that comments are more useful to me when they're non-obvious. See, again, the data structure example.
  - soulofmischief 2y ago
    I appreciate the edit and I do think we could have an enjoyable and fruitful conversation about this. Normally I would, but I have a lot going on today. I do appreciate your willingness to have a productive conversation about this topic and I apologize if I let my frustration toward some of the other commenters in this thread affect how I engaged with you specifically :)
    - LoganDark 2y ago
      To be fair I did use profanity in my original comment so I can understand the jump to frustration. Hopefully your day goes well.

soulofmischief 2y ago

How about we don't tell other people how to code? It's one thing to make suggestions, it's another to make demands. I've been doing this for a long time and I can code laps around most people. I also like well-commented code that allows me to quickly skim code and check it for correctness. You can have your preferences all you want and that's great, but when you start passing irrational judgement about the value of someone's code just because it's liberally commented, your perspective becomes less respectable.

LoganDark 2y ago
> How about we don't tell other people how to code? It's one thing to make suggestions, it's another to make demands. I've been doing this for a long time and I can code laps around most people. I also like well-commented code that allows me to quickly skim code and check it for correctness. I'm sorry, that was not intended to be received as a demand, I edited my comment to hopefully clarify. > You can have your preferences all you want and that's great, but when you start passing irrational judgement about the value of someone's code just because it's liberally commented, your perspective becomes less respectable. I didn't say anything about the value of your or anyone's code other than that obvious comments don't add any to me. (I do tend to find it funny when a comment manages to obviously contradict the code that it's about, but here that's not the case.) My point was more that comments are more useful to me when they're non-obvious. See, again, the data structure example.
- soulofmischief 2y ago
  I appreciate the edit and I do think we could have an enjoyable and fruitful conversation about this. Normally I would, but I have a lot going on today. I do appreciate your willingness to have a productive conversation about this topic and I apologize if I let my frustration toward some of the other commenters in this thread affect how I engaged with you specifically :)
  - LoganDark 2y ago
    To be fair I did use profanity in my original comment so I can understand the jump to frustration. Hopefully your day goes well.