[ubuntu-us-in] Time for a change

Daniel Dunn dan.dunn.16.62 at gmail.com
Tue Nov 20 04:41:02 GMT 2007


Thanks for the warning guys :)

-Danny

On Nov 20, 2007 9:49 PM, Simón Ruiz <simon.a.ruiz at gmail.com> wrote:
> Yes, please...and this is to all of you who write, or will ever write
> any sort of code.
>
> One day, someone may have to debug your code, so for Love's sake, COMMENT IT.
>
> At least explain your basic logic, what each "chunk" of your code is
> for, what to expect from functions, etc.
>
> Uncommented code is a pain to wade through...
>
> On the other extreme, there's no need to comment like this:
>
> # Ask the user whether the want to play a nice game of Chess.
> playChess = raw_input('Do you want to play a nice game of Chess?')
> # If they don't say no
> if playChess != 'n' and playChess !=  'N':
>     # Play Chess
>     Chess.play()
>
> If you catch my drift. This will just train people (including
> yourself) to ignore your comments.
>
> Simón
>
> On Nov 19, 2007 10:21 PM, Rob Ludwick <rob at rcludw.no-ip.org> wrote:
> > Python... it's easy to program in.  Too easy.  Debugging other's code
> > can be a challenge because type and function obfuscation is part of the
> > language, and programmers don't always document their code clearly.
>
>
> --
> Ubuntu-us-in mailing list
> Ubuntu-us-in at lists.ubuntu.com
> Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-us-in
>



More information about the Ubuntu-us-in mailing list