RE: Python Libraries: Expanding the Functions
You are viewing a single comment's thread:
Anyone who puts enough comments in their code that I can skim through it and understand what it's supposed to do (without requiring coffee and other stimulants) ... is writing absolutely glorious code.
Not only do you have comments, you have Prints!!!! I can watch the output stream and actually know where/if it crashed!
IRL, One of my functions is to take 20-30 year old code (mainly "short" scripts) from whatever language it was to a current language. Most folks don't include comments in their code ... "since everyone understands what this perl function does". If I'm fluent in the code, it's usually simple ... if not, insert coffee here.
At least now, I can lean heavily on Google to assist me ... instead of having to open up the Tomes of Knowledge. (Code reference manuals suck)
Perl... it still makes me shudder. I never got to grips with it.., and it was around 2003 when I was looking at an enormous script written by someone else and thinking... christ!
I know where you are coming from. If I don't add the comments, I will forget how it works, never mind anyone else.
Perl, Pascal, C, VB .... They all make me shudder if they aren't documented. But perl. A hash of a hash of a hash ... c'mon!!!! Without comments!!! It's a nightmare.
I have to admit ... when I think of the term "Multidimensional Hash", this is the last thing that comes to my mind!
Hrmmmm...... What does come to mind ....
Source - Legal in Canada