Gentoo Archives: gentoo-dev

From: Paul de Vrieze <pauldv@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] GLEP ??: Critical News Reporting
Date: Fri, 04 Nov 2005 09:17:38
Message-Id: 200511041015.28569.pauldv@gentoo.org
In Reply to: Re: [gentoo-dev] GLEP ??: Critical News Reporting by "Nathan L. Adams"
1 On Friday 04 November 2005 02:52, Nathan L. Adams wrote:
2 > Let me say it one more time. I'm not saying you have to have a web
3 > browser installed on the system that you are updating or installing.
4 > I'm saying that the GuideXML docs are the standard, official source of
5 > documentation and the same should hold true for the migration guides.
6 > I'm also saying that feedback from users said they want ONE official
7 > place to find this stuff. Therefor any plan that doesn't take both of
8 > those things into account is silly. And having the GuideXML-ized guides
9 > on a central website marked as the 'official-one-stop-for-errata' does
10 > not in any way shape or form preclude anyone from mirroring that info
11 > in a text file, forum post, emerge --news, mailing list, etc. etc. ad
12 > nauseum.
13
14 GuideXML would not be an appropriate format in any case. GuideXML is too
15 bloated with presentation items to be of use for such a purpose. While
16 one could argue for an xml source version, it would certainly not be
17 guidexml. This is also not necessary as it is possible to easilly apply
18 double transformations by first transforming a file into guidexml and
19 then into html. Look at the herds.xml file or projectxml for an example
20 of this.
21
22 Paul
23
24 --
25 Paul de Vrieze
26 Gentoo Developer
27 Mail: pauldv@g.o
28 Homepage: http://www.devrieze.net