It’s called “self documenting code” and the way you self document code it is by ... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

wodenokoto on Oct 9, 2024 | parent | context | favorite | on: John Carmack on inlined code (2014)

It’s called “self documenting code” and the way you self document code it is by taking all your comments and make them into functions, named after your would-be comment.

I’m not a fan either.

MetaWhirledPeas on Oct 9, 2024 [–]

Everything must be done to taste. I think code can be made "self-documenting" without going overboard and doing silly things.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact