Re: Documentation practices

2009-11-24 Thread Philip Potter
2009/11/24 Steve Bertrand : > I've noticed that the POD for several modules do not include method > usage for the functions/methods that are designed as 'internal-only'. > > I've reached a stage where not having POD for ALL of my methods is > becoming overwhelmingly cumbersome, as I have to read th

Re: Documentation practices

2009-11-24 Thread Jim Gibson
On 11/24/09 Tue Nov 24, 2009 11:09 AM, "Steve Bertrand" scribbled: > I've noticed that the POD for several modules do not include method > usage for the functions/methods that are designed as 'internal-only'. > > I've reached a stage where not having POD for ALL of my methods is > becoming ove

Re: Documentation practices

2009-11-24 Thread Shawn H Corey
Steve Bertrand wrote: > I've noticed that the POD for several modules do not include method > usage for the functions/methods that are designed as 'internal-only'. > > I've reached a stage where not having POD for ALL of my methods is > becoming overwhelmingly cumbersome, as I have to read the cod

Documentation practices

2009-11-24 Thread Steve Bertrand
I've noticed that the POD for several modules do not include method usage for the functions/methods that are designed as 'internal-only'. I've reached a stage where not having POD for ALL of my methods is becoming overwhelmingly cumbersome, as I have to read the code to remember usage. Is there a