←back to thread

Open-source Zig book

(www.zigbook.net)
692 points rudedogg | 2 comments | | HN request time: 0.429s | source
Show context
shuraman7 ◴[] No.45948508[source]
It's really hard to believe this isn't AI generated, but today I was trying to use the HTTP server from std after the 0.15 changes, couldn't figure out how it's supposed to work until I've searched repos in Github. LLM's couldn't figure it out as well, they were stuck in a loop of changing/breaking things even further until they arrived at the solution of using the deprecated way. so I guess this is actually handwritten which is amazing because it looks like the best resource I've seen up until now for Zig
replies(2): >>45948572 #>>45948933 #
tredre3 ◴[] No.45948572[source]
I've had the same experience as you with Zig. I quite love the idea of it Zig but the undocumented churn is a bit much. I wish they had auto generated docs that reflect the current state of the stdlib, at least. Even if it just listed the signatures with no commentary.

I was trying to solve a simple problem but Google, the official docs, and LLMs were all out of date. I eventually found what I needed in Zig's commit history, where they casually renamed something without updating the docs. It's been renamed once more apparently, still not reflected in the docs :shrugs:.

replies(2): >>45948684 #>>45950836 #
1. smj-edison ◴[] No.45948684[source]
Wait, doesn't `zig std` launch the autogenerated docs?
replies(1): >>45951049 #
2. geophph ◴[] No.45951049[source]
It’s currently broken, or was recently on the 0.16 dev branch (master)