ZigBook - Manuel open source pour apprendre Zig

• Zigbook est une ressource pédagogique conçue pour apprendre le langage de programmation Zig tout en transformant en profondeur la manière de penser le logiciel
• L’ouvrage comprend 61 chapitres et se distingue par un apprentissage orienté projet ainsi qu’une approche sans dépendance à l’IA
• Au-delà de la simple acquisition de la syntaxe, il met l’accent sur la philosophie de Zig et la manière de penser le développement
• Grâce à un environnement de terminal interactif, l’utilisateur peut apprendre en saisissant directement les commandes
• Proposé en open source, il soutient l’apprentissage autonome et l’extensibilité au sein de la communauté des développeurs

---

Aperçu de Zigbook

• Zigbook est un manuel open source pour apprendre le langage de programmation Zig, proposé sur le site zigbook.net
• L’objectif n’est pas simplement d’ajouter un langage de plus, mais de provoquer un changement dans la façon de concevoir le logiciel
• La formule « You came for syntax. You'll leave with a philosophy. » met en avant un apprentissage centré sur la philosophie du langage

Principales caractéristiques

• Un cursus structuré en 61 chapitres
• Une structure d’apprentissage orientée projet pour une expérience centrée sur la pratique
• La politique Zero AI est explicitement affichée, soulignant qu’il s’agit d’un contenu pédagogique entièrement rédigé par des humains, sans contenu généré par l’IA
• L’auteur est indiqué sous le nom @zigbook

Environnement d’apprentissage

• Exécutable avec la commande zig build zigbook
• L’apprentissage peut commencer directement dans un terminal interactif, avec saisie manuelle des commandes

Philosophie d’apprentissage

• L’apprentissage de Zig vise non seulement des compétences de programmation, mais aussi une évolution de la philosophie de conception logicielle et de la manière de penser
• La phrase « Learning Zig is not just about adding a language to your resume. » souligne une valeur qui dépasse une logique purement de carrière

[GN⁺]

Avis Hacker News

• Zigbook est présenté comme un travail artisanal, sans aucun contenu généré par l’IA
  qui serait continuellement mis à jour pour refléter les fonctionnalités récentes du langage et les bonnes pratiques
  On dirait qu’il est temps de créer un badge de contenu non-LLM pour distinguer ce type de contenu
  • Un projet similaire est Brainmade
  • On peut aussi citer Not By AI et No AI Icon
  • Personnellement, j’aime bien la collection de badges Created by a Human
  • Une partie du texte de présentation de Zigbook dit en substance : « Zig ne cache pas la complexité ; il l’expose et fournit des outils pour la contrôler avec précision »
    Mais comme ce style est trop parfait, certains soupçonnent que ce n’est pas vraiment l’auteur qui l’a écrit, et que cela semble avoir été rédigé par une IA
• J’aime le fait que ce livre n’enseigne pas seulement le langage, mais traite aussi du paradigme de la programmation système bas niveau lui-même
  Quand j’ai découvert Zig pour la première fois il y a un an, j’avais trouvé ça intéressant, mais j’ai fait une pause à cause des nombreux changements du langage
  En lisant ce livre, j’ai retrouvé mon intérêt. J’y ressens l’excitation que j’avais eue en découvrant Ruby pour la première fois
• Je n’ai pas encore d’expérience avec Zig, mais le livre a l’air vraiment bien
  En revanche, l’absence de version PDF est gênante. Le site est aussi lent
  En voyant le dépôt GitHub, je constate qu’il est écrit en AsciiDoc, donc je pense essayer de le compiler moi-même en PDF
  • Quelqu’un demande qu’une version PDF soit partagée si elle est créée
• Au début, c’était difficile à croire parce que ça semblait écrit par une IA
  Mais en travaillant réellement avec le serveur HTTP de Zig, j’ai constaté que les LLM n’apportaient pas de solution exacte
  À l’inverse, ce livre était précis et utile, vraiment comme s’il avait été écrit à la main
  • À force de trop dépendre des LLM, certaines personnes ont peut-être du mal à imaginer que quelqu’un ait pu écrire lui-même un projet d’une telle ampleur
  • J’aime aussi Zig, mais la documentation manque et les changements sont fréquents
    La documentation officielle comme les LLM me donnaient tous deux des informations obsolètes, et j’ai fini par trouver la réponse dans l’historique des commits
• Il y a beaucoup de débats sur le caractère généré ou non par l’IA, mais pour ma part, je pense que « si c’est bon, exact et utile, c’est ce qui compte »
  J’écris du code depuis 25 ans, mais je connais mal la programmation système, donc j’ai été impressionné par la qualité et le niveau de détail de ce livre
  • Mais quelqu’un d’autre affirme que « l’IA produit souvent des erreurs fatales malgré une apparence convaincante, donc mieux vaut l’éviter pour la rédaction de documentation »
    Comme exemple, il cite le billet Death by a Thousand Slops
  • Une autre personne dit qu’on ne peut pas comparer cela à une calculatrice
    Les calculs mathématiques n’exigent pas de créativité humaine, alors que l’écriture logicielle relève davantage d’un acte de création artistique
  • Certains estiment aussi que « si cela n’avait vraiment aucune importance, il n’aurait pas insisté sur le fait que ce n’est pas de l’IA »
  • Quelqu’un répond que « cela peut aussi venir d’un sentiment d’insécurité », et qu’il faut au final s’adapter à la réalité
• La largeur du périmètre et la profondeur du livre sont impressionnantes, mais l’ordre des chapitres est un peu déroutant
  Par exemple, il explique l’ELF avant la boucle while au chapitre 1. Cela peut être difficile pour les débutants
• L’explication des allocators est plus détaillée dans le livre, mais la section Memory de la référence du langage paraît plus concise et plus rationnelle
  Cela dit, le livre est suffisamment impressionnant pour que j’aie envie de continuer ma lecture
• On sent de l’attention et de l’affection dans tout le livre. C’est un excellent travail
• Le README du livre contient des critères précis sur l’usage de l’IA
  Il y est indiqué qu’un LLM a pu être consulté au stade du brouillon, mais que le texte final doit être relu et assumé par un humain
  C’est peut-être pour cela que certains passages donnent une impression de style IA
• Le livre affirme avoir été « écrit sans IA », mais son style ressemblait tellement à des schémas typiques de l’IA que cela m’a déconcerté
  Des structures comme « Not just X - Y » ou les phrases parallèles en trois éléments sont typiques
  Au début, j’ai cru que c’était écrit par une IA, mais en regardant le contenu de plus près, je me suis dit que cela pouvait aussi être fait à la main
  Puis, en le relisant, j’ai eu l’impression qu’il y avait des traces de retouches par IA. En particulier, les organigrammes ne paraissent pas avoir été faits par un humain
  • Chaque fois que je vois ce genre de texte, je me dis : « et si l’IA m’avait appris à écrire ? »
    Les points-virgules, les structures de comparaison et de contraste, etc., sont des schémas d’écriture traditionnels appris à l’école, ce qui brouille la frontière entre IA et humain
  • Juger si un texte est écrit par une IA uniquement à partir d’expressions comme « Not just X - Y » est une mauvaise approche
    Si l’IA utilise souvent ce type de structure, c’est parce que ses données d’entraînement contiennent beaucoup de textes écrits par des humains