[PLUG] The joy of refactoring

Paul Heinlein heinlein at madboa.com
Wed Aug 23 17:53:01 UTC 2017


On Wed, 23 Aug 2017, Tom wrote:

> Yes, Perl is fun:
> * I do not recognize any Perl code I wrote more than about year ago
>   - despite all the evidence at hand

Having been down that particular road too often, I now try Really Hard 
to write comments before coding. I fail at this frequently, but I'm 
always delighted when I succeed. I maintain a Perl script that 
analyzes my current portfolio, with data held in a YAML file, and my 
last couple editing sessions have been very smooth thanks to that 
approach.

Also, some great advice I once read about commenting: Document the 
data, not the process, unless the latter is very obscure or 
ungoogleable.

-- 
Paul Heinlein
heinlein at madboa.com
45°38' N, 122°6' W


More information about the PLUG mailing list