List Archive: gentoo-doc
Note: Due to technical difficulties, the Archives are currently not up to date.
provides an alternative service for most mailing lists.c.f. bug 424647
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.
>> 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.
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.