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@xxxxxxxxxx [mailto:fedora-docs-list-admin@xxxxxxxxxx] On Behalf Of Karsten Wade Sent: 20 November 2003 14:36 To: fedora-docs-list@xxxxxxxxxx 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@xxxxxxxxxx : http://rhea.redhat.com/ : c: +1.831.818.9995 Red Hat Enterprise Applications : WAF, CMS, Portal Server -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- fedora-docs-list@xxxxxxxxxx http://www.redhat.com/mailman/listinfo/fedora-docs-list
