-
Website
http://carlo.zottmann.org/ -
Original page
http://carlo.zottmann.org/2003/01/28/amazement/ -
Subscribe
All Comments -
Community
-
Top Commenters
-
Vicki
1 comment · 1 points
-
Hendrik Mans
3 comments · 2 points
-
Daniel Ha
2 comments · 405 points
-
kentbrew
4 comments · 2 points
-
Mark Douglass
3 comments · 2 points
-
-
Popular Threads
Amazement - The Goat Version
Everytime I think I've seen it all, I accidentally kick over another turd of that one special co-cattle of mine and find myself staring in painful amazement as I attempt to properly bury the schizophrenic droppings that is his stool. No real food, still bound yet digested books shat upon older still bound yet digested magazines, no green vegetables at all, and a mess in the first place.
The irony is that in order to rebury the abomination (that's what I'm trying to do at the moment) I have to understand what the old goat ate. Oh, the stench. Days like this one make me wish I was a programmer or an engineer.
::giggle::
~Malmuira
Edited on Jan 28th 2003, 17:35 by malmuira
And goats are good.
Mull - I doubt he would, really. :/
(It's got to be pretty damn bad to want to be a goat, though. :/ )
About obfuscated code: There was a web designer that used to work with me here who, one day, jokingly remarked "Fear my code, biotch!" And with good reason. His HTML still haunts me to this day.
I've re-written a few of the pages he did that I have to update on a semi-regular basis, but I dread the days when I have to go in and make changes to his content or code. (Un)fortunatley it doesn't happen often enough to justify entirely rebuilding those sections of our website. (Some day, but not yet... sigh)
I can only hope no one ever says that about my HTML code.....
While I agree all Code should be as clear and well notated as reasonably possible, it is also important to consider what the code is for.
If you are working in a large organisation where you know someone else will eventually inherit your work and will have to understand what you have done, then clearly notation is very important.
Me - well I work for myself. Whilst there are exceptions, 90% of the time I am the only person who will be working on my pages / databases.
Now I could add a couple of hours to each job and fully document them, but the usefulness of notation is limited, my clients will not want to pay for time which is not directed at making their software work, and if I'm a bit bloody about it I am not going to bend over bakwards to make it easier for someone else to take over my projects.
As for some mythical code monkey laughing at my work in the future. I really don't give a s**t. As long as it works, it is reliable, it is appropriately effecient and it is delivered cheaply and on time, both I and my clients are happy.
[edit] syntax (possibly an unnecessary notation?)
Edited on Jan 29th 2003, 17:47 by enid
True that. In my case, it's for a big-ass TV station website and a team-based environment - so IMHO at least clean code is in order. Hell, we're pros, so most of us don't need much documentation. If the code is good enough, you can just read thru it to understand what's it supposed to do.
But no, there're not even in-code comments...
line breaks at the beginning or end of the line??
I used to do them at the end.. then at the beginning.. and now it just depends on the flow of everything else
Have you ever had to revisit a project to make tweaks or fixes? Even if the purpose of the code is clear when you write it, a few months/years later it might not be. A well placed comment or two can really help you remember what you were trying to do and why you used a particular construct to do it.
In many cases, its both.
That's a great definition, Spam. I would also argue that part of what makes code easily understandable is sufficient, yet concise documentation.
Mulligan's eyes well up...
Rrrriiiiiiiight.... ;)
Yep. Many times. Most of what I do is database stuff, and I find almost without exception that if the db schema is right (ie simple / logical and normalised) the code is always simple.
Enids Law of Recidivistic Development: "If its hard to code, you probably have your schema wrong!"
That said, what I was really trying to say to entipy is:
Don't get too hung up on "clean" code just yet. Yes it is useful, and in some cases its critical, but get in there and write some scrappy stuff that works without worring about how clean it is. Clean can come later (if necessary). The only thing you must avoid is not even trying because of a fear that people will laugh at your "unprofessional" efforts...
enid, I'm not too hung up on it... :) However, it is difficult sometimes for me when I go back and look at previous projects.... so, I have decided to start making my code neat again. (or trying to, anyway)
That's all anyone can really do. :)
So I'm going to go to the virtual kitchen and bring you guys some beer and chex mix or something.