1 |
Hi *: |
2 |
|
3 |
I want to send this mail to make us think a little in how we are |
4 |
handling the documentation during the beta releases. The documentation |
5 |
itself it's perfect (great job Josh), but there are a couple of points |
6 |
which I think are confusing the users about what documents |
7 |
they should use. |
8 |
|
9 |
1. Currently, there are no official maintained handbooks. We have the |
10 |
networking handbooks (/doc/*/handbook/handbook-*) marked as draft and |
11 |
the networkless docs which refers to latest stable release (2007.0) |
12 |
marked as unmaintained. |
13 |
|
14 |
2. There are no docs covering a networking installation for the latest |
15 |
stable release. Users who don't want to use the beta can't find the |
16 |
docs to make a network based installation since they were overwriting |
17 |
by 2008.0 (which is still a beta). |
18 |
|
19 |
One idea for next time could be keeping current and networkless |
20 |
handbooks maintained until the release reaches an stable status and |
21 |
develop the new docs in /doc/*/handbook/beta/ and /doc/*/handbook/200X.Y/. |
22 |
|
23 |
Comments, thoughts, flames, are all welcome. |
24 |
|
25 |
P.D: Excuse me if I'm missing something and the points exposed here are |
26 |
completely wrong. |
27 |
|
28 |
-- |
29 |
Jose Luis Rivero <yoswink@g.o> |
30 |
Gentoo/Doc Gentoo/Alpha |
31 |
|
32 |
-- |
33 |
gentoo-doc@l.g.o mailing list |