Re:Storing hundreds of millions of simple key-value pairs in...
by cperciva on Tuesday November 01, 2011 @05:11PM
(#3184163)
I generally don't trust external documentation, but I do trust in-line comments.
Re:Storing hundreds of millions of simple key-value pairs in...
by catwell on Wednesday November 02, 2011 @05:09AM
(#3185906)
You're probably wrong. Look at the comment above "stretches" here: https://github.com/binarylogic/authlogic/blob/master/lib/aut...
This is crypto-related code in of the most popular Rails authentication gems. And this is one among many examples. I'm sure you've already come across something like that more than once.
I trust code rather than comments. At least it doesn't lie.
I like well documented code, I don't trust that documentation to be accurate so I don't include it in my readability score. I like to have around 10 to 40 lines per function, reasonable levels of reuses, a reasonable overall structure and function depth to stay reasonable aka f1 call f2... calls f10 is fine, f1 calls f2... calls f40 smells bad. f1 calls f2 calls f1 is fine though. And stay away from the more colorful parts of the language.
How about you?