Add "Writing Docs" to CVS (Was Re: numeric_cast - is this really right?)

From: bill_kempf (williamkempf_at_[hidden])
Date: 2002-02-08 13:08:49

I replied once to this, but the message never showed.  Hopefully I'm 
not duplicating responses.

--- In boost_at_y..., "David Abrahams" <david.abrahams_at_r...> wrote:
> 
> ----- Original Message -----
> From: "bill_kempf" <williamkempf_at_h...>
> To: <boost_at_y...>
> 
> > Is there real interest in these templates for general use (I 
assume
> > so since people ARE using them)?  If so, should I place the files 
in
> > CVS where any developer with CVS write access can tweak things in
> > order to "finalize" the documents/templates before the next 
release?
> 
> Please!

OK, I'll be making some final changes and checking the 
documentation/templates in ASAP (hopefully this weekend, but early 
next week at the worst).

> > Related to this, what are the key areas that need work in the
> > documentation/templates?  Ones I'm aware of:
> >
> > 1) Need to add more detail about tutorials/examples, including
> > possible templates.
> >
> > 2) The index template either needs work to create a single 
template
> > usable for both very large libraries and for smaller libraries, 
or we
> > need multiple templates (or possibly an XML DTD and XSLT 
transforms
> > to generate various index styles).
> 
> If that's the most convenient way for you, by all means do it, but 
please
> don't feel obliged to use these "fancy" technologies otherwise. If 
it were
> me I'd probably be hand-editing two different templates (but I've 
never
> really used XML).

The XML/XSLT approach would be nice.  Writing XML is at least as easy 
as writing HTML, and the XSLT approach would allow us to generate 
MANY different index styles.  We could even have a "global" style 
used that could be modified so that all index pages would be updated 
with out needing to modify anything other then the XSLT.  However, I 
don't have the experience/knowledge to do this myself, so at least 
initially we'll just have multiple HTML templates.

Bill Kempf