miniblog.

Too many languages introduce themselves as e.g. "Foo is a statically typed functional language", focusing on the basic characteristics. I'd rather learn why Foo is special. What is Foo great for? Get me excited about what I could do with it!

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 great perspectives from JupyterCon: reproducible/explicit state is important, notebooks are replacing bash scripts in some workflows, and they're even used to introduce programming to total beginners!