Re: [gentoo-dev] {Guide,Project, Foo}XML too confusing for many devs?

2007-03-28 Thread Denis Dupeyron
I find that as long as you read and follow the Gentoo XML Guide, writing docs is easy and using XML is handy. What I like the most is, as it was already noted, that I don't have to take care of the layout. However I have never found anything about writing project pages. Is there anything out

Re: [gentoo-dev] {Guide,Project, Foo}XML too confusing for many devs?

2007-03-28 Thread Josh Saddler
Denis Dupeyron wrote: I find that as long as you read and follow the Gentoo XML Guide, writing docs is easy and using XML is handy. What I like the most is, as it was already noted, that I don't have to take care of the layout. However I have never found anything about writing project pages.

Re: [gentoo-dev] {Guide,Project, Foo}XML too confusing for many devs?

2007-03-28 Thread Paul de Vrieze
On Wednesday 28 March 2007, Josh Saddler wrote: Denis Dupeyron wrote: I find that as long as you read and follow the Gentoo XML Guide, writing docs is easy and using XML is handy. What I like the most is, as it was already noted, that I don't have to take care of the layout. However I

Re: [gentoo-dev] {Guide,Project, Foo}XML too confusing for many devs?

2007-03-28 Thread Denis Dupeyron
On 3/28/07, Paul de Vrieze [EMAIL PROTECTED] wrote: I do (sort of), and it is documented at: http://www.gentoo.org/proj/en/metastructure/projectxml.xml Unfortunately I don't know of any page that uses all features, but if you look around you can find some. Thanks Paul, that's exactly what I

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-28 Thread Vlastimil Babka
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Chris Gianelloni wrote: On Mon, 2007-03-26 at 12:01 -0500, Mike Bonar wrote: Should we encourage more content to go into the wiki, expecially content that is likely to change over a short period of time? Gentoo has no wiki. Not entirely true,

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-28 Thread Vlastimil Babka
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Anant Narayanan wrote: I guess the point of last year's GuideXML SoC project was to help devs who didn't find writing GuideXML *cough* exciting *cough* enough. Which is why I developed Beacon [1]. Looks like the project hasn't been as successful

Re: [gentoo-dev] {Guide,Project, Foo}XML too confusing for many devs?

2007-03-28 Thread Paul de Vrieze
On Wednesday 28 March 2007, Denis Dupeyron wrote: On 3/28/07, Paul de Vrieze [EMAIL PROTECTED] wrote: I do (sort of), and it is documented at: http://www.gentoo.org/proj/en/metastructure/projectxml.xml Unfortunately I don't know of any page that uses all features, but if you look

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-28 Thread Chris Gianelloni
On Wed, 2007-03-28 at 14:29 +0200, Vlastimil Babka wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Chris Gianelloni wrote: On Mon, 2007-03-26 at 12:01 -0500, Mike Bonar wrote: Should we encourage more content to go into the wiki, expecially content that is likely to change over a

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-28 Thread Anant Narayanan
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi Vlastimil, I think it lacks advertisement, IMHO many people just know there was such project but have no idea if it was completed or what. And having it online (at least some demo) would help greatly so people can easily try it out without

[gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Alec Warner
First off, this is not a discussion on why XML sucks, or why we shouldn't be using XML or anything like that. This is not a discussion about what we should be using instead of XML. This is a discussion about using XML for our webpages. Many projects have old and nasty webpages. This has been a

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread William L. Thomson Jr.
On Mon, 2007-03-26 at 08:05 -0700, Alec Warner wrote: my basic question is do you as a developer find writing web pages to be confusing or difficult? As one who does a fair amount of web development myself. I rather like the guidexml formatted docs. Writing them is not a big deal at all. Do

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Kevin F. Quinn
On Mon, 26 Mar 2007 08:05:58 -0700 (PDT) Alec Warner [EMAIL PROTECTED] wrote: do you as a developer find writing web pages to be confusing or difficult? No. Is there not a good tutorial for learning our webpage XML syntax? For my use, I've found the available docs sufficient. Do you find

RE: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Mike Bonar
-Original Message- From: Alec Warner [mailto:[EMAIL PROTECTED] Sent: Monday, March 26, 2007 10:06 AM To: gentoo-dev@lists.gentoo.org Subject: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs? snip my basic question is do you as a developer find writing web pages

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Catalin Zamfir Alexandru
On Monday 26 March 2007 15:05, Alec Warner wrote: First off, this is not a discussion on why XML sucks, or why we shouldn't be using XML or anything like that. This is not a discussion about what we should be using instead of XML. This is a discussion about using XML for our webpages. Many

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Mike Frysinger
On Monday 26 March 2007, Alec Warner wrote: Many projects have old and nasty webpages. This has been a problem within gentoo since before I arrived and probably has been a problem since we started having webpages. One of the issues I wish to address is whether or not writing webpages in XML

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread José Luis Rivero (yoswink)
Alec Warner escribió: So this is getting pretty long winded; my basic question is do you as a developer find writing web pages to be confusing or difficult? Is there not a good tutorial for learning our webpage XML syntax? Do you find that you bump up against restrictions in the DTD or other

RE: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Chris Gianelloni
On Mon, 2007-03-26 at 12:01 -0500, Mike Bonar wrote: Should we encourage more content to go into the wiki, expecially content that is likely to change over a short period of time? Gentoo has no wiki. -- Chris Gianelloni Release Engineering Strategic Lead Alpha/AMD64/x86 Architecture Teams

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Jakub Moc
[snip] Err, where the heck has gone the GuideXML editor project that was part of last SoC? (And yeah, I've heard from quite a couple of people that they are not touching any docs because the GuideXML thing is something they'd rather avoid like plague). -- Best regards, Jakub Moc

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread José Luis Rivero (yoswink)
Jakub Moc escribió: [snip] Err, where the heck has gone the GuideXML editor project that was part of last SoC? Its name is 'beacon' [1] and is developed by our dev Anant Narayanan who probably can give you more info about it. [1] http://code.kix.in/projects/beacon/ -- Jose Luis Rivero

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Lars Weiler
* Alec Warner [EMAIL PROTECTED] [07/03/26 08:05 -0700]: So this is getting pretty long winded; my basic question is do you as a developer find writing web pages to be confusing or difficult? I'm one of the few people who like XML. Probably it's because I don't have to care for the design and

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Dawid Węgliński
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 José Luis Rivero (yoswink) napisał(a): Alec Warner escribió: So this is getting pretty long winded; my basic question is do you as a developer find writing web pages to be confusing or difficult? Is there not a good tutorial for learning our

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Anant Narayanan
Many projects have old and nasty webpages. This has been a problem within gentoo since before I arrived and probably has been a problem since we started having webpages. One of the issues I wish to address is whether or not writing webpages in XML (Guide or Project or something_else) is

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Chris Gianelloni
On Mon, 2007-03-26 at 21:46 +0200, Lars Weiler wrote: But back to the question you started your message with: The outdated project-pages. My opinion is, that GuideXML is not the blocker for updating them. It's more a menpower issue. Exactly. Even projects that I am heavily involved in, do I

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Paul de Vrieze
On Monday 26 March 2007, William L. Thomson Jr. wrote: On Mon, 2007-03-26 at 08:05 -0700, Alec Warner wrote: my basic question is do you as a developer find writing web pages to be confusing or difficult? As one who does a fair amount of web development myself. I rather like the guidexml

Re: [gentoo-dev] {Guide,Project,Foo}XML too confusing for many devs?

2007-03-26 Thread Paul de Vrieze
On Monday 26 March 2007, Lars Weiler wrote: There are for sure some difficulties with our DTD, especially for our project-pages.  Adding a news-entry at top or putting the elements in a fixed order. And that is mostly because of the nature of DTD's. As soon as you want to require items you

Re: [gentoo-dev] {Guide,Project, Foo}XML too confusing for many devs?

2007-03-26 Thread Alec Warner
Thanks for all the replies (and the offers of help, very comforting). I will no longer accept the excuse of 'I can't write GuideXML' since we have an army of volunteers to GuideXMLify stuff for us :) As such, I don't need to learn (I know enough to get by, and with this glep index I'll soon know