Contact
This guide is written and maintained by Rajesh Pillai. Corrections, questions and requests all go to the same place, and all of them are read.
Something on a page is wrong
This is the most useful thing you can send. Open an issue on the issue tracker. A report that can be acted on straight away usually has four things in it:
- The URL of the chapter.
- Your Zig version, from
zig version. The guide targets master and was last verified against 0.17.0-dev.1525+91c6d8a09; a good half of reports turn out to be a tagged release meeting code written for master, which is what coming from an older Zig covers. - What you expected to happen.
- What happened instead, with the error message pasted in full.
If a snippet does not compile for you on current master, that is a build failure waiting to happen and worth reporting immediately. Every snippet is compiled and run nightly, so it should not be possible, and if it is happening then something about the check is wrong too. How that check works is written up in how this guide is verified.
A chapter is missing, or one is unclear
Also the issue tracker. Say what you were trying to do and where you got stuck. "I could not work out how to do X" is more useful than a proposed table of contents, because the gap is usually somewhere other than where it feels like it is.
A correction you have already written
Pull requests are welcome at github.com/rajeshpillai/zig-guide. Every snippet is a real file that the build compiles and runs, so a change to example code is checked automatically the moment it is pushed. The repository's own notes describe how snippets are classified and what a new one needs.
Anything else
Rajesh is on X as @rajeshpillai, and reachable through the same GitHub account for anything that does not belong in a public issue.
What this site cannot do
It has no accounts, no comment system and no server. Nothing here can receive a form submission, store a message, or email you back, which is why every route above leaves this domain. The same fact is why there is so little to say on privacy.