1 |
On Friday 04 November 2005 02:24, Nathan L. Adams wrote: |
2 |
> I have read it, and I find it lacking; thus the comments. Or are you |
3 |
> claiming that the idea of having a central website like errata.g.o with |
4 |
> GuideXML-ized migrations guides is in your GLEP? Its not. I'm proposing |
5 |
> adding that as the definative source of the errata, and feeding it to |
6 |
> other places (emerge --news, mailing lists, forums, GWN) as desired. |
7 |
|
8 |
I agree with Ciaran here. Emerge --news should be authoritive. I'm not |
9 |
opposed to erata.gentoo.org, but it is easy to generate from the tree. If |
10 |
there would be a master format to generate both from, that would also be |
11 |
OK, but news items in the tree is probably the best answer. And it is |
12 |
easy to display when pretending. One could even give a warning (in |
13 |
advance) when a user is trying to update an affected package (perhaps |
14 |
this should be an extra header item). |
15 |
|
16 |
> |
17 |
> I'm also commenting on the part that *wrongly* states "It is not |
18 |
> reasonable to expect all users to have an MTA, *web browser*, email |
19 |
> client, cron daemon or text processing suite available on their system. |
20 |
> In particular, this means that any markup to be parsed must be in a |
21 |
> very simple format." |
22 |
> |
23 |
> *ALL* of the official docs are GuideXML; Gentoo *expects* users to have |
24 |
> a web browser by default. Otherwise a vast majority of users would |
25 |
> never get Gentoo installed in the first place. The "lightweight" |
26 |
> requirement appears to just be your way of subverting the current |
27 |
> documentation standards (because of your XML hatred). |
28 |
|
29 |
No, gentoo expects people to have access to a webbrowser. But not all the |
30 |
time. It is perfectly reasonable to expect people to make a nice printout |
31 |
of the handbook at the office, and then take it at home to install a nice |
32 |
new gentoo box. |
33 |
|
34 |
> The news directory shouldn't the main source of the migration guides; |
35 |
> the website should be (one central page that can feed other sources). |
36 |
|
37 |
The website should not as it a pull source of information. It requires |
38 |
users to actively acquire the information. What is worse is that some |
39 |
users might not update for a prolongued time (6 months). At that time |
40 |
they will not find the information in the erata list anymore. But they |
41 |
will get the RELEVANT news delivered by emerge/enews. |
42 |
|
43 |
Paul |
44 |
|
45 |
-- |
46 |
Paul de Vrieze |
47 |
Gentoo Developer |
48 |
Mail: pauldv@g.o |
49 |
Homepage: http://www.devrieze.net |