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

From: David Abrahams (david.abrahams_at_[hidden])
Date: 2002-02-08 11:43:25

----- Original Message -----
From: "bill_kempf" <williamkempf_at_[hidden]>
To: <boost_at_[hidden]>

> 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!

> 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).

-Dave