3 ms·
Indeed! This is very well documented, not necessarily by the comments per line but the explanatory information. It's a shame that most people nowadays write s
by IncRnd 6y ago
Indeed! This is very well documented, not necessarily by the comments per line but the explanatory information. It's a shame that most people nowadays write self-documenting code.
- jacquesm 6y agoI still write exactly like that today, and as the years progress I've found more often than not that this is what keeps code fresh and re-usable, it also helps that be able to read the code when re-entering a portion that was untouched for a while.
- MarkMoxon 6y agoAbsolutely this - I’ve tried to explain things clearly in the commentary, not least so I can understand them again when I revisit bits of the code. I’ve got about 15 new deep dives that I'm going to be writing next, now that I've done the website, so that part of the site should get more interesting over time. This is version 1.0, really. There’s an awful lot more to say about this game - it’s endlessly fascinating.
- simonw 6y agoThank you so much for this - it really is a masterclass in how to annotate code. I'll be pointing people to this for years to come!
- jacquesm 6y agoThank you for all the hard work, it is super nice to see code at this level of quality and at this level of comments. Interesting question: did you find any bugs just by reading?