Boost logo

Boost :

Subject: Re: [boost] ATTENTION: Library requirements..
From: Rainer Deyke (rainerd_at_[hidden])
Date: 2016-01-08 04:32:15

On 07.01.2016 18:11, Robert Ramey wrote:

> Useful applications of javascript that occur to me are:
> b) syntax coloring for code examples

I disagree that this is a valid use of Javascript. Code examples are
static, so they can and should be statically colored. This means that
the syntax highlighting exists even if Javascript is disabled.

> So I think the javascript admonition should be softened
> to say - "Documents should be readable with browsers
> which have javascript disabled" or something to that
> effect.

That's too soft for my taste, as it leaves open the possibility that the
documentation without Javascript is unnecessarily feature-crippled (but
still readable). I think that Javascript should only be used as a last
resort, when there is no other way to provide the same functionality
without Javascript.

Rainer Deyke (rainerd_at_[hidden])

Boost list run by bdawes at, gregod at, cpdaniel at, john at