A breakdown of how the Redis source code got comments right.

http://antirez.com/news/124

Comments should provide context, not repeat what the code already says. The Redis codebase has 9 distinct types of comments (Function, Design, Why, Teacher, Checklist, Guide, Trivial, Debt, Backup), each with a specific goal in mind.

38 points · 3 comments · view on lemmy.world

3 Comments

scottmeme@sh.itjust.works · 6 pts · 3y (1 reply)

This site doesn't support HTTPS

spartanatreyu@programming.dev · 7 pts · 3y

Oh damn, you're right. It's sending an outdated certificate.

Here's a secure link: https://web.archive.org/web/20230607041256/http://antirez.com/news/124

EthicalAI@beehaw.org · 4 pts · 3y

That right there is a masterclass. Thanks