FUDforum
Fast Uncompromising Discussions. FUDforum will get your users talking.

Home » Imported messages » comp.lang.php » Got a chuckle and wanted to share.
Show: Today's Messages :: Polls :: Message Navigator
Return to the default flat view Create a new topic Submit Reply
Re: Got a chuckle and wanted to share. [message #181276 is a reply to message #181274] Mon, 29 April 2013 13:37 Go to previous message
Richard Yates is currently offline  Richard Yates
Messages: 86
Registered: September 2013
Karma:
Member
On Mon, 29 Apr 2013 04:45:08 +0100, The Natural Philosopher
<tnp(at)invalid(dot)invalid> wrote:

> On 29/04/13 03:42, Doug Miller wrote:
>> Scott Johnson <noonehome(at)chalupasworld(dot)com> wrote in news:klk9mf$ce8$1@dont-
>> email.me:
>>
>>> I understand what NP is saying though. I have revisited code I wrote
>>> years ago. I know I must of been in 'the zone', because some of the
>>> algorithms (some) where just short of brilliant and trying to figure out
>>> what I was thinking without comments (kind of wipes out the brilliant
>>> part I know), was like an outer body experience.
>> And that is why I *always* comment code whose purpose is not immediately obvious: self-
>> defense. Even with a large applications group, you still wind up maintaining a lot of your own
>> code, maybe years later: "Hey, who wrote this module? Doug did? OK, Doug, you get to do
>> this enhancement." Never mind the fact that Doug is now the sysadmin, and hasn't worked in
>> apps development for five years... Naah, that'd never happen... Would it?
> I think what happens with me anyway, is that after a while I have more
> or less the whole structure and design in my head, and coding is just a
> matter of writing the mental picture in the language. The temptations is
> to do that but IF the actual concept is flawed or its got lost in
> translation its vile to debug without the comments.
>
> Often I will write the pseudo code as a comment and see if the code
> actually corresponds..

My best commented code happens when I start by writing a complete
outline of the module with each line starting with // and then write
the code between the comments.

Doing that first exposes logic errors since I am thinking of the
overall flow without being bothered by little syntax details. It also
makes writing the code easier since the tasks are all broken down into
manageable and logical pieces. Then when it's done the code is already
commented as if by magic and i don't have to do that drudgery.

Of course, I don't always discipline myself to do it that way, but I
am always glad when I have done so.

Richard Yates
[Message index]
 
Read Message
Read Message
Read Message
Read Message
Read Message
Read Message
Read Message
Read Message
Previous Topic: determine a mysqli_result object
Next Topic: displaying image
Goto Forum:
  

-=] Back to Top [=-
[ Syndicate this forum (XML) ] [ RSS ]

Current Time: Mon Nov 25 01:26:00 GMT 2024

Total time taken to generate the page: 0.03542 seconds