Lobste.rs

Yap: a particular kind of slop

IMG_2170

yap (verb) to talk in a shrill insistent way Comments Writing code comments has always been hard, because communicating is hard. It’s hard to not assume context. It’s hard to use the right terminology consistently. It’s hard to even put comments in the right spots to begin with. It generally takes me several iterations of rewording a comment to get something I’m happy with. I’ll write something lousey that takes 5 times as long to read as it should, and then read it. Then I’ll remove a couple sentences, tweak what remains and do it again. There is no compiler to statically analyze and verify your comments. A comment can be wildly inaccurate and yet the code will run in blissful ignorance. When you change a type, or a function signature, or a variable name you must update the rest of the…

Continue reading at Lobste.rs mckayla.blog
Advertisement