I like the side by side docco thing. I remember underscore or lodash doing that. A nice way to view source. Almost like it's annotated.

Zig lacks documentation, and thats because its hard.

Documentation of the kind: "ThingDoer: Does the thing" is not useful. A lot of the Zig stdlib docs are exactly that.

It's especially hard because the stdlib changes quite a lot still. Examples go out of date so adding documentation like this is not just one-time work. I am working my way through learning the language and it's not uncommon to find blog posts or news snippets from 4 months ago introducing features, and they already don't compile.