[erlang-questions] Erlang documentation -- a modest proposal

Richard A. O'Keefe <>
Thu Sep 29 01:39:35 CEST 2016



On 28/09/16 10:22 PM, Anthony Ramine wrote:
>
> So why do you hardwrap all your emails by hand to 50 columns? You are wasting my real screen estate. Do you hate me? :(

E-mail is not documentation.

As to why I do it, your unwrapped lines are truncated in my MUA.

>
> Syntax colouring of examples usually need JS because otherwise

the HTML markup to be downloaded becomes really heavy.

Syntax colouring is something we're better off without.

Why?  Because it makes *irrelevant* distinctions that are
already apparent in the text, at the price of reducing the
contrast, thereby making the code less readable.

If syntax colouring were easily controlled by the end-user,
that might be tolerable.


More information about the erlang-questions mailing list