Re: [gentoo-doc] Improving organization during beta release

[Xavier Neys]

Jose Luis Rivero wrote:
> Hi *:

>  1. Currently, there are no official maintained handbooks. We have the
>  networking handbooks (/doc/*/handbook/handbook-*) marked as draft and
>  the networkless docs which refers to latest stable release (2007.0)
>  marked as unmaintained.

/doc/en/handbook/ and /doc/en/handbook/2008.0/ are officially maintained.
Them being marked 'draft' does not make them any less official.
/doc/en/handbook/2007.0/ is officially unmaintained.

>  2. There are no docs covering a networking installation for the latest
>  stable release. Users who don't want to use the beta can't find the
>  docs to make a network based installation since they were overwriting
>  by 2008.0 (which is still a beta).

draft was moved up because anyone using the latest docs and a 2007.0 media on 
a modern system (read about 1 year old or more recent) could not go very far 
in the installation process. Besides, those completing a 2007.0 install would 
then need to upgrade some many packages that it was deemed better to move up 
the draft version.

> One idea for next time could be keeping current and networkless
> handbooks maintained until the release reaches an stable status and

Networkless will always be under xxxx.y
2007.0 is still there, 2008.0 is already there.
If anything needs to change, the arches that have a GUI installer would only 
get "pop CD into your reader, boot, follow on-screen instructions". Done!

> develop the new docs in /doc/*/handbook/beta/

That is done in /doc/en/handbook/draft/
We moved it up earlier than at official release time as already explained.


Cheers,
-- 
/  Xavier Neys
\_ Gentoo Documentation Project
/
/\ http://www.gentoo.org/doc/en/