On 2016-01-08 12:40, Sam Kellett wrote:
On 8 January 2016 at 09:32, Rainer Deyke
wrote: 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.
that's massively open to human error and adds a substantial workload on the dev which could be better spent (re)writing the actual documentation content to a better level.
Coloring is done automatically by QuickBook/BoostBook and doesn't require human intervention. I believe other source formats should also have this capability without involving JS. If you're writing plain HTML then yes, you would have to do this yourself, but that's just one of your problems as writing HTML is a pain in general. Probably, this is the reason why noone does this nowdays.