News for hackers. Stuff that matters.
Re:A Guide to Naming Variables by Roboprog on Friday May 13, 2016 @12:29PM (#11691333)
I'm OK with the "one word" parameter / return value names, in part, I guess, because I'm also a big proponent of a "pro forma" comment banner for every routine. For simple things, the comment can be a one-liner ("Return thing X"), but otherwise, explain each param and the return value.

Now, if the internal variables require a "data dictionary" level set of comments, that's another matter. Something is (usually) wrong in that case.

There are no comments on this comment yet.