Re: [boost] Not yet approved library documentation mark

From: Darren Garvey (darren.garvey_at_[hidden])
Date: 2007-11-01 05:53:49

On 31/10/2007, David Rodríguez Ibeas <dibeas_at_[hidden]> wrote:
>
> <snip>
>
>    What I am proposing is that in any and all not-yet-approved library
> that
> is proposed to boost the docs (ideally close to the title) document the
> status, for example in
> http://www.revergestudios.com/boost-exception/boost-exception.htm title
> could read:

One really simple way to achieve this is to modify the image that appears on
the top-left of the docs. Some people on the 'net have 'Not yet' red stamps
plastered over that image, which works very nicely IMO.

If boost had a few variants of the image - for instance, pending,
under-review, accepted, next-release - then accepted libraries could point
to the relevant image using for example:

boostbook standalone
  : generated_docs_xml_target
  : <xsl:param>boost.image.src=http://boost.org/images/logo_pending.png ;

Where logo_pending.png (doesn't exist yet) would have 'pending' stamped on
the image.

Regards,
Darren