Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

“ Zig is a young project and unfortunately we don’t have yet the capacity to produce extensive documentation and learning materials for everything” - documentation as an afterthought. Thanks, I’ll look elsewhere.


TBF it doesn't make much sense to put much effort into detailed documentation as long as the language isn't stable yet. And what's already there of documentation is more then enough to be productive, at least if you don't mind nosing around the standard library's source code a bit (which is very educational too, so win-win).


Documentation is not an afterthought. There is specific structure for do strings. IIRC Completion of documentation is on the roadmap, it's just in the icebox until a certain set of other features is complete.

Tbh, i think it's a great strategy. As wonderful as it is, zig has enough bugs in it still that you don't want total newbies all in yet, and this acts as a bit of a gatekeeping device (which will be lifted in due time) and also keeps negatively predisposed people "looking for excuses to not use zig" out -- as I'd say works really well in your case!


This was discussed recently on Zig Showtime: https://youtu.be/pacsngNYXI0?t=2217




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: