I know my XML/XSLT , but I dont know squat about docbook, where would be a good place to find an overview?
-----Original Message----- From: Shawn Anderson [mailto:[EMAIL PROTECTED]] Sent: 04 October 2001 06:15 To: [EMAIL PROTECTED] Subject: RE: DOC Project format I am all for the XML/XSL DocBook concept as well :) And I'll even help write the setup/installation section as soon as we have a central place to check files in an out.. Shawn -----Original Message----- From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]] Sent: Thursday, October 04, 2001 5:26 AM To: [EMAIL PROTECTED] Subject: RE: DOC Project format XML/XSL is a good technology, you can have one core document, maintained by someone who knows XML/XSL , and translate it to HTML,TEXT,PDF and many other formats in seconds. It allows everyone to have a copy of the manual in their favorite format. The only reason that XML/XSL would get in your way, is if you want to make additions to the manual. i'm sure in the long term a web interface could be set up that would'nt require much in the way of skills to use, and in the short term whoever ends up maintaining the manual will probably be happy to add your changes. -----Original Message----- From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]] Sent: 03 October 2001 19:57 To: [EMAIL PROTECTED] Subject: Re: DOC Project format As it turns out, I couldn't care less what tool you use to make the doc. If it is poorly organized, and contains the same information - then it's not going to be a good tool for someone trying to understand xmail server. I thought perhaps the installation guide should be put together to please the users, and not the programmers. Davide (and others) already said they don't want to learn a new publishing program to create and maintain this doc. David Bitton, I take it you market the docbook tool? Why not tell us why you feel that it's the way to go instead of republishing the same examples over and over again? Those examples only demonstrated that the resulting document would be unpleasant to look at, and as poorly organized as the exisitng document. I must admit, I thought it was a real nice touch the way you added "Edited By David Bitton" to the example doc - and in such nice, big type too! So - why docbook? No more samples - just some answers. Tell us why thats the "only way" to go. ok? ----- Original Message ----- From: "David Bitton" <[EMAIL PROTECTED]> To: "Davide Libenzi" <[EMAIL PROTECTED]> Cc: <[EMAIL PROTECTED]> Sent: Wednesday, October 03, 2001 7:32 PM Subject: Re: DOC Project format > What is being missed here is the issue is not output > format, but input content management. Ok, so you want > RTF, ok... > > http://www.codenoevil.com/Xmail/xmail.rtf > > all that took was changing two items in the single > command line command it took to create that. > > Ladies and Gentlemen, DocBook is the way for > management, we can see that. As for output, the > format is the limit. Oh yeah, I did up a HTML frames > version too: > > http://www.codenoevil.com/Xmail/frames.htm > > but do pardon the broken image links for now. I > didn't feel like editing the .js file to add images/ > to each image filename ('course when we roll this out, that'll be a > no-brainer). > > Davide, let's get the CVS setup and let me plop some > file in and let's get going. > > -dave > > > --- Davide Libenzi <[EMAIL PROTECTED]> wrote: > > On Wed, 3 Oct 2001 [EMAIL PROTECTED] wrote: > > > > > The present documentation is a terrible struggle > > to use for these reasons, > > > as well as grammer, spelling, and other general > > english language concerns. > > > > You should have seen it two years ago :) > > > > Everyone agree on RTF ? > > > > > > > > > > - Davide > > > > > > > ===== > ---- > David B. Bitton > [EMAIL PROTECTED] > > We will overcome. > http://www.libertyunites.org > > __________________________________________________ > Do You Yahoo!? > NEW from Yahoo! GeoCities - quick and easy web site hosting, just $8.95/month. > http://geocities.yahoo.com/ps/info1 >
