On Mon, 26 Mar 2007 08:05:58 -0700 (PDT)
"Alec Warner" <antarus@gentoo.org> 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 that you bump up against restrictions in the DTD or other
> problems that prevent you from expressing yourself properly?

No.  I do try to keep things simple, which may be why.

> Do you have any idea how to actually go about extending GuideXML
> (or the other XML's we provide)  Have you ever tried?

No and no - I've never had the need.

> Could we improve training with regards to any of this?

Do we really expect people to hack around with the DTDs?  I thought the
whole point is that you stick to the stuff provided by GuideXML.  We're
not writing fancy interactive websites - we're just writing some docs.

All that said, I've only ever written single-page docs.  I don't _like_
GuideXML, but have no inclination to do anything differently for
Gentoo website stuff, and it's sufficient for the stuff I've used it
for.

I wouldn't want to write anything sizable in XML, as the markup just
gets in the way, much like many other markup languages (LaTeX, GROFF
etc).  Docutils' RST (reStructuredText) is much better in this regard;
its markup is much less intrusive than anything else I've used.

-- 
Kevin F. Quinn