Gentoo Archives: gentoo-dev

From: Alec Warner <antarus@g.o>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?
Date: Mon, 26 Mar 2007 15:09:04
1 First off, this is not a discussion on why XML sucks, or why we shouldn't
2 be using XML or anything like that. This is not a discussion about what
3 we should be using instead of XML. This is a discussion about using XML
4 for our webpages.
6 Many projects have old and nasty webpages. This has been a problem within
7 gentoo since before I arrived and probably has been a problem since we
8 started having webpages. One of the issues I wish to address is whether
9 or not writing webpages in XML (Guide or Project or something_else) is
10 just too much of a barrier for many people. I've personally always been
11 pretty much a 'copy something that works and edit the bits I need' kind of
12 a guy. There is certainly a large body of work to steal^H^H^H^H^Hcopy
13 from. However when something you are working on doesn't fit inside of
14 something that has already been done it becomes very difficult to make it
15 'fit' into our existing XML structure.
17 This forces you to either ask for help from the masters of GuideXML (aka
18 the Docs team) or try and figure out how the hell to write the xsl and
19 dtd's yourself, or give up. Personally I think most people end up at the
20 latter case (the giving up one). I know developers that won't even touch
21 any webpages at all; I can only assume that they just hate XML long time
22 and find the whole issue of writing pages complicated and burdoning.
24 So this is getting pretty long winded; my basic question is do you as a
25 developer find writing web pages to be confusing or difficult? Is there
26 not a good tutorial for learning our webpage XML syntax? Do you find that
27 you bump up against restrictions in the DTD or other problems that prevent
28 you from expressing yourself properly? Do you have any idea how to
29 actually go about extending GuideXML (or the other XML's we provide) Have
30 you ever tried? Could we improve training with regards to any of this?
32 Thanks,
34 -Alec
36 --
37 gentoo-dev@g.o mailing list