Re: quo vadis, docs

[Phil Bull <philbull gmail com>]

Hi Shaun,

On Mon, 2009-02-09 at 11:26 -0600, Shaun McCance wrote:
[...]
> Steps that would help:
> 
> 1) Make it easier to run the latest development version.  I got
> myself set up for working on 2.25 documentation yesterday, in
> part to review your patches.  It took me most of the day Sunday
> just to get 2.25 in front of me.  And I'm a programmer.  Most
> potential writers are not.
> 
> 2) Provide better documentation for how to write documentation.
> The GDP Handbook is outdated and overwhelming.
> 
> 3) Make documentation easier to write.  Mallard can help.
> 
> 4) Make it easier to see what documentation needs work.  Pulse
> can help.
> 
> 5) Ensure the community can respond to potential new members.
> This means that either I have to have a lot more free time, or
> we need more trusted community members alongside me.  The former
> doesn't seem likely, and the latter is kind of a Catch-22.
> 
> In my experience, (1) and (5) have been the biggest problems.
> People grumble about the other three, but they usually manage
> to figure it out.

I'll help out with (5) if you're happy for me to do so.

Thanks,

Phil

-- 
Phil Bull
https://launchpad.net/people/philbull