miniblog.

I've been writing programming language documentation for objects. It's surprisingly nuanced! How do you introduce objects to the reader? What elements should the first example contain? What order do you introduce concepts like methods, inheritance and properties?

Some cunning NLP research which has found that really simple statistical models (e.g. does the sentence contain "not"?) is sufficient to answer a good number of text comprehension datasets: https://thegradient.pub/nlps-clever-hans-moment-has-arrived/

Python is the only language I've seen where the stdlib docs contain smilies: https://docs.python.org/3.6/library/heapq.html#theory It makes the docs more approachable, but also shows the diversity of writing styles used!