maradydd: (Default)
[personal profile] maradydd
Nothing written using Boost is ever self-documenting.

(no subject)

Date: 2008-07-07 12:26 pm (UTC)
From: [identity profile] mouser.livejournal.com
Corollary: Nothing is ever REALLY self-documenting. It just seems like it.

(You don't believe me, look at any code you haven't touched in a year...)

(no subject)

Date: 2008-07-07 01:13 pm (UTC)
vatine: Generated with some CL code and a hand-designed blackletter font (Default)
From: [personal profile] vatine
It actually helps having someone asking you about the code. I had reasons to revisit an old codebase I cobbled together (and basically stoipped working on) Jan-Mar 2007 and once I had had a glance at the code, it wasn't too bad, even if there's almsot no comments (I'd climb out on a limb and say "completely undocumented", but there's a few design docs and at least one protocol spec in the code tree, even if it's not in the code itself).

(no subject)

Date: 2008-07-07 10:07 pm (UTC)
From: [identity profile] maradydd.livejournal.com
Oh, indeed; that's why I adhere to the Next Jackass Principle ("always comment your code thoroughly for the next jackass who will have to maintain it, because 95% of the time, the next jackass is you"). Thanks to the comments, I knew what the routine in question was supposed to be doing; however, it took a couple of minutes to re-grok the template-sludge enough to figure out how. Fixed now.

(no subject)

Date: 2008-07-07 01:48 pm (UTC)

(no subject)

Date: 2008-07-07 09:42 pm (UTC)
lawnrrd: (Default)
From: [personal profile] lawnrrd
The phrase that you're looking for is "write-only language."

(no subject)

Date: 2008-07-07 10:08 pm (UTC)
From: [identity profile] maradydd.livejournal.com
And yet I can read Perl. But not write it. Go figure.

Profile

maradydd: (Default)
maradydd

September 2010

S M T W T F S
   1234
567891011
12131415 161718
19202122232425
26 27282930  

Most Popular Tags

Style Credit

Expand Cut Tags

No cut tags