Anaconda documents

[Alexander Rau (work)]

Took my lunch break to look into the creation of fedora-docs. And I have to
agree with Taylor:

"Taking a look at the Documentation project site, I see that I need
Docbook XML, stylesheets, Emacs PSGML (or NXML), etc.  What is the
learning curve for these?  I have never done XML, and I am not an Emacs
user (sorry to start a flamewar).  Perhaps I could write the text and
someone with more knowledge of XML/Emacs could put it into the right
format.  I am not unwilling to learn XML/Emacs, but my time might be
spent better elsewhere."

This is very discouraging!!


AR


-----Original Message-----
From: fedora-docs-list-admin at redhat.com
[mailto:fedora-docs-list-admin at redhat.com] On Behalf Of Karsten Wade
Sent: 20 November 2003 14:36
To: fedora-docs-list at redhat.com
Subject: Re: Anaconda documents

On Thu, 2003-11-20 at 10:02, Tom Diehl wrote:
> On Thu, 20 Nov 2003, Taylor, ForrestX wrote:
> 
> > Hi all,
> > 
> > I am new to the list, although not new to Red Hat Linux.  I am
> > interested in writing docs for anaconda, so, is anyone was already
> > working on them?
> > 
> > Taking a look at the Documentation project site, I see that I need
> > Docbook XML, stylesheets, Emacs PSGML (or NXML), etc.  What is the
> > learning curve for these?  I have never done XML, and I am not an Emacs
> > user (sorry to start a flamewar).  Perhaps I could write the text and
> > someone with more knowledge of XML/Emacs could put it into the right
> > format.  I am not unwilling to learn XML/Emacs, but my time might be
> > spent better elsewhere.
> 
> Are there non-Emacs solutions available for this??

Any editor will suffice, but unless you have an intimate knowledge of
DocBook XML, you will find it difficult to use an editor which does not
have a mode similar to PSGML or nXML.

If you know how to indent properly, etc., it's really less of an issue
which editor you use and more of an issue for collaboration if you use
the tab character instead of spaces for tabs. :)

One editor I am keeping my eye on is http://www.conglomerate.org/.  They
are thinking in novel ways that make using a GUI editor tempting.

At Red Hat, we have a relatively standardized way of doing things.  We
can share .emacs changes and keep everyone able to edit each other's
projects, etc.  It will be interesting to see how we resolve the lack of
homogeneity in Fedora Project docs.  These are, after all, open
standards, so if you can accomplish the same thing using other tools, 
more power to you.

- Karsten
-- 
Karsten Wade   :      Tech Writer, RHCE     :  o: +1.831.466.9664
kwade at redhat.com : http://rhea.redhat.com/ :   c: +1.831.818.9995
    Red Hat Enterprise Applications : WAF, CMS, Portal Server           
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --


--
fedora-docs-list mailing list
fedora-docs-list at redhat.com
http://www.redhat.com/mailman/listinfo/fedora-docs-list