The only thing stopping me from using Zig is the lack of docs
Zig taught me to read stdlib source, which I do at my $dayjob now too.
It is perfectly fine to read stdlib source. Start with lib/std/mem.zig after reading the docs about the language.
It is much more readable than the C "docs" ISO/IEC 9899:2011. I am so productive now. :)
Zigs stdlib have near zero usable docs.
Yes I know you can browse the code, but thats difficult since the zig lsp has very little idea about a lot of types.
I'm not saying it works for everyone but frankly, like motiejus it sounds, I don't mind the minor challenge of being forced to read source code.
Right now the best doc is to look at the tests in the code itself.