OCAML's Official Tutorial Blatantly Suck
After 2 decades, OCaml's official tutorial still blatantly suck.
here's a quote from the official tutorial:
As far as I can tell OCaml doesn't have single-precision floating point numbers at all.
from official ocaml tutorial https://ocaml.org/learn/tutorials/basics.html
We have, a advanced language, encompassing advanced type theory and compiler science, yet, in 20 years, the official tutorial displays guessing words and weasel writing?
'tis not just ocaml. This is a epidemic that's in unix, perl, python, haskell, and even clojure. [see Idiocy of Computer Language Docs: Unix, Python, Perl, Haskell]
There's something deeply wrong here. Something deeply wrong about the computing industry, or somewhere.
programers, either totally don't give a fuck about documentation (they relpy on “grok”, y'know?), or, are totally antithetic to writing documentation. (too clumsy with the pen?)
oh, wait, but LOOK! yonder there hacker types, have and embrace and trumpet Literate programming.
you heard of literate programing, right? That is, when people want writing code to become like writing prose. We see the fandom of such in emacs, in perl, in whatever current fashion of language, everywhere, non-stop for 2 decades.
one hand wants to write doc at all times, while the other hand can't be bothered with basic tutorial.
Ask me question on patreon