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

Is that not common knowledge? I feel like this is a well-written post with a good point but it's a familiar point. You could boil part of it down to 'all's good in moderation', so don't just keep your code clean, keep it clean and easy to read, etc.


I didn’t mean to imply there’s anything novel in my post :-) someone’s gotta beat that drum once in a while.


Thank you Dan, your posts have been a great source for a lot of us out here.


It's a great post anyway, sorry if my tone was too critical. I enjoyed reading it, for what it's worth, just felt like expecting anything surprising or revelatory out of it wouldn't be the right approach.


Leaving common knowledge undocumented is, in itself, a misguided attempt at DRY.

Your common knowledge isn't necessarily everyone's common knowledge; what you perceive isn't necessarily what it is.

Every day there are many people just starting to code. There are cultural and regional differences. They might not have hit the exact spot in which this information appears.

Knowledge also disappears, fades, gets censored or destroyed, gets mixed up and remembered incorrectly. You might take something as a given and misremember it 20 years from now. You might read your own code 5 years from now and not know why something's there — something that was taken to be obvious.


It definitely is something that needs to be said, as it is not uncommon to find people doing the opposite: taking a rule-of-thumb and asserting that it is the one true way. The people who are most likely to make this mistake are smart and well-motivated, enthusiastic about the power of abstraction to simplify things, and have some experience but not a lot.




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

Search: