| 1 |
On Sat, Apr 26, 2008 at 09:42:38PM +0200, Xavier Neys wrote: |
| 2 |
> Jose Luis Rivero wrote: |
| 3 |
>> 1. Currently, there are no official maintained handbooks. We have the |
| 4 |
>> networking handbooks (/doc/*/handbook/handbook-*) marked as draft and |
| 5 |
>> the networkless docs which refers to latest stable release (2007.0) |
| 6 |
>> marked as unmaintained. |
| 7 |
> |
| 8 |
> /doc/en/handbook/ and /doc/en/handbook/2008.0/ are officially maintained. |
| 9 |
> Them being marked 'draft' does not make them any less official. |
| 10 |
|
| 11 |
"Disclaimer : This document is a work in progress and should not be |
| 12 |
considered official yet." |
| 13 |
|
| 14 |
Probably people reading this is not going to consider them as official. |
| 15 |
|
| 16 |
> |
| 17 |
>> 2. There are no docs covering a networking installation for the latest |
| 18 |
>> stable release. Users who don't want to use the beta can't find the |
| 19 |
>> docs to make a network based installation since they were overwriting |
| 20 |
>> by 2008.0 (which is still a beta). |
| 21 |
> |
| 22 |
> draft was moved up because anyone using the latest docs and a 2007.0 media |
| 23 |
> on a modern system (read about 1 year old or more recent) could not go very |
| 24 |
> far in the installation process. Besides, those completing a 2007.0 install |
| 25 |
> would then need to upgrade some many packages that it was deemed better to |
| 26 |
> move up the draft version. |
| 27 |
|
| 28 |
Maybe some kind of warning or note about this can help the people to |
| 29 |
understand the situation. |
| 30 |
|
| 31 |
> |
| 32 |
>> One idea for next time could be keeping current and networkless |
| 33 |
>> handbooks maintained until the release reaches an stable status and |
| 34 |
> |
| 35 |
> Networkless will always be under xxxx.y |
| 36 |
> 2007.0 is still there, 2008.0 is already there. |
| 37 |
|
| 38 |
"Disclaimer : This handbook has been replaced by a newer version and |
| 39 |
is not maintained anymore." This warning in 2007.0 is not going to make the |
| 40 |
users go for this and if you try to find a newer version all you have is |
| 41 |
a beta. Same problem than above. |
| 42 |
|
| 43 |
I'm for keeping networkless under xxxx.y but keep the latest stable |
| 44 |
version out of 'unmantained' could help during beta phase. |
| 45 |
|
| 46 |
>> develop the new docs in /doc/*/handbook/beta/ |
| 47 |
> |
| 48 |
> That is done in /doc/en/handbook/draft/ |
| 49 |
> We moved it up earlier than at official release time as already explained. |
| 50 |
|
| 51 |
ACK. |
| 52 |
|
| 53 |
Thanks Xavier. |
| 54 |
|
| 55 |
-- |
| 56 |
Jose Luis Rivero <yoswink@g.o> |
| 57 |
Gentoo/Doc Gentoo/Alpha |
| 58 |
|
| 59 |
-- |
| 60 |
gentoo-doc@l.g.o mailing list |
Archives