Très long

Je trouve ton howto très long avec beaucoup de texte et il rentre assez bien dans la description de la xkcd #1343 :
XKCD #1343 sur l'utilité des manuels qui commencent par « comment lire ce manuel »

Je pense que l'approche est orienté usage, ça c'est cool, mais il n'y a pas de sommaire (on ne sait donc pas rapidement ce qu'on va découvrir avec ton tuto). Les usages sont AMHA vraiment trop basiques, tu explique à des gens comment faire ce qu'ils savent déjà faire, pourquoi est-ce qu'ils liraient ? Ajoute des cas simples pas facile à faire autrement (supprimer tous les pdf ?).

Les paragraphes débutant par « Note. » discutent de détails (techniques, historiques,...) qui ne sont pas nécessaires à la compréhension du tutoriel lors une première lecture.

Alors pourquoi les mettre ? Met les en bas de la page ou qu'elle s'affiche uniquement si on clique sur une icône. C'est suffisamment long pour ne pas ajouter encore des détails.

Remarque dactylographique. Notons qu'un des motifs qui peuvent rebuter un débutant dans la ligne de commande, est le simple fait qu'il faut écrire des commandes, et qu'écrire demande en soi une certaine compétence avec le clavier sous peine de se sentir mal à l'aise, lent, et d'avoir peur de faire des erreurs. C'est pour ça que sans doute un apprentissage de la dactylographie au clavier à l'aide par exemple d'un logiciel comme klavaro est une bonne idée, voire un prérequis pour une utilisation intensive des notions abordées dans ce tutoriel. C'est aussi un bon investissement en général pour quiconque ayant à écrire des textes substantiels de temps en temps (mail, rapport, etc...).

Non, ça ne me semble pas pertinent d'en parler ou en tout cas pas là au début. Tu ajoute encore une barrière à la lecture. Si tu veux parler de ça, met-le à la fin AMHA.

Pour le débutant, la ligne de commande apparaît parfois comme quelque chose de magique, les vieux sages disent que c'est puissant etc... donc c'est compliqué. En fait, pas du tout, vous faites des choses plus compliquées tous les jours (comme lire jusqu'ici).

Non tu peut l'enlever ça sert à rien et ça catégorise ton lecteur, ce qu'il n'a pas forcément envie. Dire à son lecteur qu'il est un débutant, qu'il existe des vieux sage, ça donne pas particulièrement envie. Pourquoi parler de niveau. Tu peut commencer avec quelque chose de plus entraînant comme « on va découvrir ensemble comment se servir de ... ».

[...] on se retrouve donc en ligne de commande : c'est-à dire une invite de commande [...]

Je suis pas certain que « invite de commande » soit plus compréhensible que « ligne de commande ».

À mon avis finir l'introduction sur man et apropos n'est pas une bonne idée. Ça devrait être à la fin (« maintenant que vous avez suivi ce tuto, comment continuer à apprendre/progresser ? »). (Edit : en continuant ma lecture je vois que tu en parle plus en détail après, donc vraiment juste pas la peine d'en parler avant)

Il suffit de fermer la fenêtre. Mais on peut aussi utiliser la commande exit sans arguments.

Ou Ctrl+d (=EOF).

---

Ton tuto est sympa, peut être sombre (moi ça me plaît, mais je ne suis pas sûr que ça plaise à tout le monde).

La meilleure manière de convaincre tes lecteurs c'est de leur montrer le plus rapidement possible ce qu'il peuvent faire et pas de passer 5 minutes à dire que oui c'est compliqué mais promis on présente que des choses simples. Je pense qu'il faut que tu réduise ton intro et ton avant-intro pour que les gens aillent plus vite sur le contenu utile.

Grosso modo je suis entrain de t'expliquer que ton tuto est bien, mais qu'il va prendre des TL;DR à tire-larigot.

Tous les contenus que j'écris ici sont sous licence CC0 (j'abandonne autant que possible mes droits d'auteur sur mes écrits)