A place for developers to talk about building on Farcaster.

/dev

what's some programming advice that's considered common sense or that you hear often, but is actually bad advice?

building /cabin (cabin.city). founder of LBRY.com, odysee.com, vibe.camp, /farcon. more at grin.io

Founder /kiwi-news, a decentralized Hacker News

Comments: Never explain what your code does in comments. Only write them when you want to persist info that hasn't already been expressed in code (e.g. context)

Consistency: Inconsistency makes people feel bad. Your code still runs. It's emotional/irrational to write consistent code, just bc it makes you feel better

so if you misinterpret this (actually good) advice in a way that is pretty obviously not the intended meaning, it’s bad :)

it’s like saying “drink water” is bad advice because it’s possible to drink a harmful amount

I don‘t compare software to e.g. a physical activity intentionally. Software is like writing English: almost anything can somehow be achieved somewhat. Drinking water is objective because you die without. But for software, inconsistent an uncommented code exists and runs just fine.