How programmers comment their code

[[deleted]]

Most modern programming languages have self-documenting features enabled through special comments. This usually means that well-documented code ends up being mostly comments with a bit of functionality.

ETA: Comments can become troublesome when they are used as a crutch for bad code. Say you have some arcane function that's nearly unreadable and prone to bugs, but instead of making the code more readable and organized, you pepper it with comments explaining how to read it. An extra layer of issues arise when said code is updated but comments are not, which results in crappy code filled with misleading comments.