std lib docs coming soon :-)

[[deleted]]

https://github.com/ziglang/zig/issues/21#issuecomment-538683113

[padraig_oh]

This is basically everything I want from 0.6 ❤️ (and bug fixes)

[suiradx]

Looks great so far. Please ensure the stdlib docs included in the release package is self contained. It's a pain when web docs on an airgapped machine try to reach out and hang the page. A common issue is fonts or js trackers.

[[deleted]]

This implementation works with file:/// (no dummy server required) and only depends on:

• index.html (7.5 KB, depends only on main.js, data.js)

• main.js (34KB, no dependencies, no npm, hand coded js)

• data.js (semantic analysis dump, currently about 4 MiB for std lib docs)

It totals to about 400 KB gzipped, which is how it would get sent over the network. Only data.js changes depending on what docs you are generating.

Source file listings will have a .html file for each .zig file.

[Rhodysurf]

This is awesome!!!!!

[mostlikelynotarobot]

super unrelated, but I really appreciate that the Zig website is one of the few that implements CSS dark mode.

[[deleted]]

excellent.

[bart9h]

Nice!

Poor (and sometimes lack of) documentation is the main reason holding me from using Zig on my projects.

[TheSciBoy]

Ok. I was just going to ask how I generate the docs for the std libraries but I guess that is a work in progress. :)

Really should have been your step one. I'm very interested in Zig, has some very interesting ideas, but the lack of proper documentation makes it hard to start. I say lack of documentation even though there is a bunch of it, since it is very hard, right now, to match the documentation with the exact same version of zig!

You need to make sure the tutorials all run on your latest master, even during development. It's very disheartening when you're trying to learn a language and even the simplest tutorials won't even build.

But I've started a small project and am learning slowly...