HackerTrans
TopNewTrendsCommentsPastAskShowJobs

jlc

no profile record

comments

jlc
·5 anni fa·discuss
I'll amplify nand2tetris.

And I'll throw in The Little Schemer and Understanding Computation. They come from a different direction than Code/nand2tetris. When I got that they all sort of meet in the middle, I found it mind-blowing.
jlc
·5 anni fa·discuss
LOL. I'm going to explain this for myself and then never look at this cursed thread again.

What is important is to clearly communicate the intent of code to the next developer (incl., yourself) who comes across it. Comments are one tool provided to do this. I write comments. I approve pull requests containing comments. But comments are not the only tool, and they're not the best one.

Now most of the time there's no particular difficulty establishing the intent of code. Sometimes, though, there's something weird, something that looks "wrong" but isn't. In those cases, I isolate the weird change using abstractions (at least a variable, but probably a function, a method, a class); I name it and any components well -- long, descriptive, using appropriate conventions; I put automated tests around it, which will fail if anyone changes it without understanding it, providing helpful and explicit error messages (where tools allow); and I write a developed, full explanation in a commit message (which IME will not be too hard to track down, if you've isolated the "weird" change using an abstraction).

That will almost always communicate the the intent. If it doesn't, I (reluctantly) comment it up.
jlc
·5 anni fa·discuss
Typically, it isn't digging. It's the last commit, maybe the one before it, and I have tools for doing this (e.g., magit, fugitive).

I don't notify anyone, nor do I need to. When I encounter a WTF moment, I look at the commit messages. When there's nothing there, I curse the last developer.

I guess it can be fun spelunking through commit messages, though, to see when the comment was added and if it still applies.
jlc
·5 anni fa·discuss
IMO commit messages are for why.
jlc
·5 anni fa·discuss
Oh! The Professor and the Madman by Simon Winchester
jlc
·5 anni fa·discuss
Off the top of my head:

The Soul of a New Machine by Tracy Kidder

A Supposedly Fun Thing I'll Never Do Again by D.F. Wallace

Speak, Memory by Vladimir Nabokov

Anything by John McPhee

Edit: formatting
jlc
·5 anni fa·discuss
I love domino games. I used to play a lot of two-hand sniff (or muggins -- lots of variants). For me there's something aesthetically pleasing about games that use generic gaming equipment -- dominoes, cards, pawns, etc.
jlc
·5 anni fa·discuss
I enjoyed BBS and also Get Lamp, by the same director.

I hope I'm missing something, but I don't seem to be able to find it in its entirety, and its DVD is also sold out.

http://www.getlamp.com