This isn't specific to Zig. But most thing you said is a feature not a bug. Let me quote from the release note. >This Release Contains Bugs, Zig has known bugs

This isn't specific to Zig. But most thing you said is a feature not a bug. Let me quote from the release note. >This Release Contains Bugs, Zig has known bugs and even some miscompilations. >Zig is immature. Even with Zig 0.12.0, working on a non-trivial project using Zig will likely require participating in the development process. I dont think documentation should be priority for Zig at this stage, just read the Release Note and you will see how things are changing and breaking all the time. But I do agree certain things should be documented, as suggested in another reply is the Spec and build system.