RE: Jade FAQ sorely needed

Subject: RE: Jade FAQ sorely needed
From: "Didier PH Martin" <martind@xxxxxxxxxxxxx>
Date: Sat, 1 May 1999 09:19:35 -0400
Hi Frank,

Good. Easy and don't hesitate, Write it and post it.

If you set a site, you can post my texts on it (just ask, I'll send you my
texts). Same thing, if you want that your texts are to be posted on my new
dsssl site, I'll post it there too.

But the best motto here is: Just do it.

Anxious to read your first FAQ. Thank you very much Frank for your what
you'll bring to the DSSSL community.

Didier PH Martin
mailto:martind@xxxxxxxxxxxxx
http://www.netfolder.com

-----Original Message-----
From: owner-dssslist@xxxxxxxxxxxxxxxx
[mailto:owner-dssslist@xxxxxxxxxxxxxxxx]On Behalf Of Frank Wegmann
Sent: Friday, April 30, 1999 4:12 PM
To: dssslist@xxxxxxxxxxxxxxxx
Subject: Jade FAQ sorely needed


As some of you are actually on the way for an improved Jade this
would also be the right
moment to establish a FAQ for installing/using Jade (in its current
form as well as in its future
yet-to-be-shaped form).

I did't yet work too much with Jade, but felt a FAQ would be very
valuable to newcomers.
Some very good work has been done already (e.g. the tutorial by
Prescod and especially
the Documentation Project hosted at Mulberry), but material
typically covered in a FAQ
is not always (or easily) found. This is what I think should be
handled by a FAQ:

* General Aspects
  What's Jade? in general, with regard to CSS/XSL/XFO... - what's
implemented?

* Installation Issues
  The Easy Way - How To Compile Yourself (hey, nobody told me about
how to compile on my NeXT,
  but it works!)
  How To Configure a Working Environment (here I see a chance for
the Debian guys to step in
  with some remarks..)

* Using Jade
  How to use the backends - some common scenarios (got XML/SGML, now
where is the HTML output?),
  Common Pitfalls

* DSSSL
  (*not* intended to interfere with DSSSL Doc Project etc.)
  Expression Language - Transformation Language - The Standard (uh oh)
  Typical Constructs Needed and Used
  Workarounds for features not (yet) implemented

Well, this is not thoroughly reviewed, just popping off my mind, sorry.
Nevertheless I think it would be a contribution to the community and
attractive for newcomers.
If people appreciate this idea, I would gladly step in as a
maintainer and even start writing
some items (if some of you are willing to correct my non-native English).

Any comments?

Frank Wegmann



 DSSSList info and archive:  http://www.mulberrytech.com/dsssl/dssslist


 DSSSList info and archive:  http://www.mulberrytech.com/dsssl/dssslist


Current Thread