[Idea] Zelf Book: A book that makes you learn Zig!

Showcase
1

During the last two years, I learned so much about the Zig programming language (by creating an own OS). Sometimes, learning things about Zig was really hard.
So I decided to make the lives for people after me (that want to learn Zig) a bit easier and wanted to create an eBook / webpage for people that want to learn Zig (similar to https://pedropark99.github.io/zig-book/).

However, this book currently has no contents. The reason for that is that I want to plan the contents of that book together with the Zig community.

If you are interested, head over to https://codeberg.org/zelf-book/pages and create a new issue for a certain Zig language aspect you want to be covered in that book or for an example project you’d like to see (and yes, in the following days I’ll open issues for aspects / projects too; I just haven’t come to doing that right now).

And yes, this book has a strict no-AI policy (as the license implications of LLM-generated output are unclear and I don’t want to spend more time reviewing AI slop than the people spent creating it).

13 Likes
2

Small update: Initially, I wanted people to write custom XML for an XSLT stylesheet (which then should have transformed it to HTML).
However, after some more research, it seems like browsers would like to deprecate XSLT. So I’ll use the extremely simple Gemtext markup with a JS renderer.
(just wrote this here in case people were afraid of having to write custom XML :slight_smile: )

2 Likes
3

My proposal is to write a book to your younger self and write mainly about things what you find interesting.

Why? Otherwise there is the danger, that writing that book will not be fun and you just abort your project. Also there is no book which can cover everything.

2 Likes