teastep at shorewall.net
Thu Dec 4 11:31:52 PST 2003
On Thu, 2003-12-04 at 09:23, Mike Noyes wrote:
> On Thu, 2003-12-04 at 08:54, Tom Eastep wrote:
> > On Thu, 2003-12-04 at 08:43, Mike Noyes wrote:
> > > I have found that cvs is used, if the documentation is in a format that
> > > can be manipulated easier than html (e.g. DocBook XML). We finally found
> > > a tool (xxe) that allows pseudo WYSIWYG editing of DocBook XML. This
> > > greatly helped our guide creation, but it hasn't helped our FAQs. A Wiki
> > > is our next step, in an effort to keep them current.
> > I must be missing something here -- I do WYSIWYG HTML editing using
> > Mozilla Composer; that's the way that all of my documentation was
> > created. Are you saying that the "pseudo WYSIWYG" editing in xxe is
> > preferable?
> * DocBook XML can be transformed into multiple target formats
> (e.g. plain text, html, pdf, man pages, etc.)
> * Content is separated from presentation.
> * Automatic index, xref, contents, etc. generation.
> * Output customizable with DocBook XSL Stylesheets
> There are probably more benefits I forgot.
Ok -- So in your experience, people are willing to contribute to printed
documentation but not on-line?
Tom Eastep \ Nothing is foolproof to a sufficiently talented fool
Shoreline, \ http://shorewall.net
Washington USA \ teastep at shorewall.net
More information about the Shorewall-users