Re: [gentoo-doc] Handbooks / Autobuilds: What needs to be done?

[Nathan Zachary]

Ben de Groot wrote:
> Josh Saddler wrote:
>
>> AllenJB wrote:
>>
>>> Is there a breakdown of tasks for updating the handbooks for autobuilds?
>>>
>> This is something that I've brought up on this list all the way back at
>> the beginning of March[1].
>>
>> As of right now, no one's bothered to reply on the list, nor respond
>> when I jump on to our IRC channel.
>>
>> But as I'm the only one doing any work these days, I have no idea when
>> the rest might be completed. As far as I know I'm the only one to even
>> start to consider all the things that need to be changed.
>>
>> [several points...] That's it for now, I guess.
>>
>
> To me this sounds like an issue that needs to be brought to the
> attention of the council. Having good documentation has always been one
> of the strengths of Gentoo. It would be sad to see that wither away
> because of lack of manpower or lack of interest. Maybe we need to do
> some targeted recruiting for the documentation team.
>
> Cheers,
>
I have contributed a document to the documentation team.  While it is 
unrelated to the autobuilds and the handbook, it shows interest in the 
team.  I know that Josh has been doing an immense amount of work for the 
doc team, which is evidenced by his name showing up as "editor" on tons 
of the existing documents.  As Ben said, documentation is one of the 
strongest points of Gentoo, so we cannot let it go by the wayside.  I'm 
willing to learn the ins and outs of editing existing documents, and the 
other aspects of the doc team.

Two people actively working on documents is not enough either, but it 
will hopefully offset some of the labour.  I don't think that the team 
would have any trouble finding volunteers to help out with editing, and 
that an announcement should be made on the forum.

--Zach