Fork me on GitHub
#gratitude
<
2023-03-07
>
craftybones09:03:06

@bozhidar - your comments in code are gold. I wish more of us develop this discipline and clarity of thought. I was looking at https://github.com/nrepl/bencode/blob/master/src/bencode/core.clj and https://github.com/nrepl/bencode/blob/4286ceef3cc7e9531b8e1650d0a1ff243b150dcd/src/bencode/core.clj#L89 beautifully illustrates a quirk in reading bytes in Java that code by itself would never convey. Your comments are often there to explain your motivation and rationalisations. I’d rather take code with great comments than code with 100% test coverage. Thanks a lot.

gratitude 39
cider 12
🤯 2
💯 2
😄 2
bozhidar11:03:03

I can't take credit for those particular comments, as they were written by Meikel Brandmeyer. 🙂 But I totally agree with your assessment of their beauty and usefulness.

🎉 6
keychera11:03:50

wow! that is so awesome, I want to try writing code like that too

dgb2315:03:40

It reads like a literate program!

craftybones15:03:46

@bozhidar - ah. A git blame was in order perhaps, but my point still remains. I’ve seen you talk about this a few times

cider 2
eggsyntax18:03:05

Is Meikel on this slack? Maybe worth tagging them if so (I don't see any active obviously-correct username).