From: | Lehlan Decker DeckerL@******.com |
---|---|
Subject: | [semi-OT] programming languages' evolution |
Date: | Mon, 01 Feb 1999 16:52:29 -0500 |
>code does is force you to produce minimal documentation. If
>you did that anyways, it doesn't make a difference.
If I understand this one right I have to disagree. There is no
excuse for not having code documented well. Sure I can write up
documentation, but then 5 years from now I have to have the
source code, and the documentation and look at the
documentation while I modify the code. Much easier to look
at the the comments in front of a section of code etc, and see
what it does, then to try and track it down in a manual.
In a previous job incarnation, I had to go back and modify
multiple's people's code, and I spent more time cussing them
then I did anything else. I have to admit its one of the few things
that they actually harped on and took points off for in college.
I remember a few folks loosing nearly a letter grade for
ill-documented code. The way to check it, they gave it to someone
else to fix or change.
To tie this to shadowrun.....I have no idea. I'll get back to you on
that one.
------------------------------------------------------------------------------------
Lehlan Decker, Unix Admin (704)331-1149
deckerl@******.com Fax 378-1939
Moore & Van Allen, PLLC Pager 1-888-608-9633