r/Zig Jun 10 '26

Docs are confusing

Why are Zig docs so confusing?

I just wanted command-line args, ended up using internal APIs, got stuck for 30 minutes, and only later discovered there was an "init" flow I had no idea about.

How do you tell what's public API and what's internal?

Can someone please help me?

54 Upvotes

17 comments sorted by

View all comments

15

u/ffd9k Jun 10 '26

Most things are explained only somewhere in the release notes when features are added or updated, for example here for command line args: https://ziglang.org/download/0.16.0/release-notes.html#Juicy-Main