Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot
 
PerlMonks  

Re^2: The sourcecode *is* the documentation, isn't it?

by dfaure (Chaplain)
on Jun 15, 2004 at 08:45 UTC ( [id://366818]=note: print w/replies, xml ) Need Help??


in reply to Re: The sourcecode *is* the documentation, isn't it?
in thread The sourcecode *is* the documentation, isn't it?

Let the source code say what you are doing, add comments to say why you are doing it

I totally, completly agree with you. There's no worst comments than those duplicating informations given by the code since usual coding practices tend to make forget having them synched.

Until you're not a Befunge of APL developer, the language you code with has usually enough semantic elements helping you to understand what is meant in there.

Nota: English is not my mother longue but I can manage to understand approximatively what is meant here without any comments available :-)

HTH, Dominique

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://366818]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others surveying the Monastery: (7)
As of 2024-03-28 21:57 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found