I share the sentiment. I've been programming for ~20 years and I've done a fair share of low level development in c and c++. I like the idea of zig and honestly I want to adopt it, but the language syntax feels so counter intuitive. Maybe I'm just less patient the older I get.
You can't RTFM. The language is in development and any manual would get out of date fast. It's better use of their limited resources to focus on completing the language, then focus on the manual once the language is not a moving target.
Well, to be fair, they could easily have an LLM pass over the existing code as a CI pass, and generate the language documentation for each checkin.
But they don't like LLM's [according to the author, I don't actually know or care if it's true], so... shrug
If you are gonna use LLMs to put the code in prose, skip the middleman and just read the code & tests directly, it is actually pretty readable.