[sureglymop]

Because the language is not stable at this point and hasn't reached 1.0?

Are you saying one should never make anything half finished available to the public? This post proves why it is valuable to do so, they are getting valuable feedback and a discussion on hacker news for free.

[viraptor]

There's an alternative of being much more up front about the status. For example the project page doesn't really say it's unstable/experimental. It only says "Zig has not yet reached v1.0" on the "getting started" page, which doesn't really mean that much - for example Putty is still at 0.83 after 26 years.

If the project invites me to use it "for maintaining robust, optimal and reusable software." without putting "super unstable, we don't even care about docs" on the same page... that's also saying something.

[throwawaymaths]

AIUI the team has a geberal consensus on what is left tp do before 1.0, there's even a tracking list of requirements on the github.

if you have that attitude about docs, then likely you are being gatekept from the project until it hits 1.0.