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.