Re: [boost] Boost documentation with ability for users to post comments

Subject: Re: [boost] Boost documentation with ability for users to post comments
From: Robert Ramey (ramey_at_[hidden])
Date: 2015-06-06 15:44:32

On 6/6/15 11:46 AM, Glen Fernandes wrote:
> Does the section at
> http://www.boost.org/development/requirements.html#JavaScript still
> apply, regarding use of Javascript in documentation?

That ship sailed 10 years ago.  I put Javascript in the documentation 
for the serialization library in 2003.  Shortly after, it was added to 
the Streams library.  The issue was raised - but no one objected.  Even 
a browser which doesn't support javascript would be cool with it.  So it 
doesn't apply.

This illustrates why we need this facility in the Boost documentation. 
If we had it, the fact that the information is no longer operative would 
have been added to the pages years ago.  note the self-reference here.

I'm definitely going to put this into the documentation for the safe 
numerics library.  When I get around to moving the serialization 
documentation from raw html to boost book, I'll add it in there as well.

Robert Ramey