(Re)penser le chapitrage

[thom4parisot]

Le chapitrage m'ennuie un peu aujourd'hui. J'avais l'intuition que le chapitre 2 était trop long. C'est confirmé :

$ find . -type f -name 'index.adoc' -exec wc -lw {} \;
    1141    5759 ./appendix-a/index.adoc
     792    6426 ./chapter-01/index.adoc
    3320   19731 ./chapter-02/index.adoc
     138     387 ./chapter-03/index.adoc
    1816   12580 ./chapter-04/index.adoc
      41      93 ./chapter-05/index.adoc
     912    6000 ./chapter-06/index.adoc
      34     203 ./index.adoc

Le chapitre 2 est trois fois plus long que le premier chapitre.

Du coup je m'interroge sur l'ordre : y'en n'a pas. Bon en vrai, avoir installé Node est un bon pré-requis pour les exercices pratiques — certains exemples sont fonctionnels dans un navigateur web pour diminuer la hauteur de la première marche.

Aussi, donner une intention à chaque chapitre me plairait. Si on peut le deviner/comprendre au titre, c'est encore mieux.

Là comme ça je dirais :

1. L'histoire, l'écosystème et la gouvernance • ça marche comment la vie de Node et des gens qui le font ?
2. Installer, mettre à jour et développer • ça marche comment si je veux utiliser Node sur une machine ?
3. On joue avec JavaScript • ça marche comment JavaScript ?
4. On joue avec Node • ça marche comment les modules ?
5. On joue avec npm • ça marche comment l'outil npm ?
6. On déploie notre code • ça marche comment côté hosting ?
7. On fait une application web • ça marche comment HTTP ?
8. On fait un outil en ligne de commande • ça marche comment du code métier dans le terminal ?
9. On fait une application frontend • ça marche comment les modules Node dans les navigateurs web ?

• Annexe : Sélection de modules npm
• Annexe : Design Patterns

Dans une autre édition :

• On fait du traitement de données • ça marche comment le streaming ?
• On fait un service web événementiel • ça marche comment un micro-service ? / ajouter des fonctionnalités à Google Spreadsheet
• On fait une application desktop • ça marche comment si je veux publier une app Windows/Linux/macOS ?
• On fait de la haute disponibilité • ça marche comment si on veut exploiter tous nos CPU ?
• Annexe : Ce livre est lui-même construit avec Node.js

[thom4parisot]

Ce que @DavidBruant voudrait savoir à propos du streaming :

• piper en ligne de commande
• stream un gros fichier pour faible empreinte mémoire
• faire la même chose sur le réseau

[thom4parisot]

On apprend à jouer avec npm

• package.json
• package-lock.json
• npm install
• npm init
• npm run
• npm test
• npm link
• yarn
• package.json en tant que fichier de config (babel, eslint, browserify, husky)
• les autres trucs qui utilisent "npm le repo" (TypeScript, Atom)

Pour le fun :

• npx

[thom4parisot]

Conclusion :

    1140    5743 ./appendix-a/index.adoc
     736    4331 ./appendix-b/index.adoc
     414    3881 ./chapter-01/index.adoc
     414    2266 ./chapter-02/index.adoc
    1113    6270 ./chapter-03/index.adoc
    1065    5957 ./chapter-04/index.adoc
     492    3518 ./chapter-05/index.adoc
     912    5992 ./chapter-06/index.adoc
     139     388 ./chapter-07/index.adoc
     107     259 ./chapter-08/index.adoc
    1816   12580 ./chapter-09/index.adoc

C'est plus équilibré ; les contenus ne sont pas terminés mais y'a des chances que ça finisse tout aussi équilibré.