Re: [boost] ATTENTION: Library requirements..

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