Re: Doing Something For Better Documentation

On Monday, April 21, 2003, at 02:24  PM, Casey West wrote:

> Rather than fishing for solutions, I'm willing to take the ball and do
> something useful for documentation.  See patch below.
>
> I'll take this to the [email protected] mailing list and
> start an editorial overhaul.  There are a set of goals, I'll give an
> overview here.
>
>   - Correct spelling and grammar.
>   - Consistency with term usage.
>   - Up to date examples conforming to popular coding practices.
>   - More internals documentation.
>   - Expansion.
>   - Organization.
>   - etc, etc.
[ snip ]

Just wanted to mention that I did this in late 2000 for perlfaq, only 
with regards to spelling, grammar, and term use.  I also did 
perlunicode last summer.  So maybe the other documentation could be 
done first?

It takes a long time, but it's quite rewarding to submit a 1,000 line 
patch (with the only actual corrections occurring every 8 lines or so).

I guess I should also point out that I would like to help on your 
coordinated effort to fix up everything.

Yours,
John Borwick
Raleigh, NC, USA