kickaha: (Default)
kickaha ([personal profile] kickaha) wrote2007-02-28 01:02 am

Now I know how parents feel on the first day of kindergarten

Tonight I cleaned up the code, wrote some basic bootstrapping docs, and made available on the SVN server back at UNC... my dissertation code. Another student wants to hack on it and see where he can take it. Good luck, bud, you're going to need it. It's somewhere between 25 and 30 kLOC of dense Python code, and a few dozen XML files against a custom schema with some support XSLTs. All thoroughly documented, of *course*. *whistles tunelessly*

Weird feeling though - someone else is going to take my beloved mindchild out, and play with it. Strange feeling.

Actually, I take that back, this isn't like the first day of kindergarten, this is like being a parent on prom night. :}

Re: Documentation

[identity profile] kickaha.livejournal.com 2007-02-28 10:01 pm (UTC)(link)
It's not. Not at all. :P

If only there were some way of extracting the semantic meaning of code...

Re: Documentation

[identity profile] georgmi.livejournal.com 2007-02-28 10:15 pm (UTC)(link)
You know, my dad never talked to me about drugs, or smoking, or the birds and the bees. His talk on alcohol, delivered once when I was sixteen, was: "If you really feel like you need to drink, there is beer in the fridge. Don't take it outside the house, and your friends are not allowed to have any." (I suspect he was thinking specifically of _you_, by the way. :) )

But from the time I was about eight, I heard regularly about the importance of proper documentation of one's code, from flowchart and pseudocode through code comments and accompanying whitepapers. In specific and, as it would turn out, useful detail. I was the only third-grader in my school who had his own flowcharting template, let alone the skills to use one.

Doesn't *every* parent have that talk with their kids?