Salut Luthaf,
Je suis en charge de la validation de ton tutoriel et je viens te faire mes premières remarques. Voici comment j'ai procédé :
- D'abord, j'ai effectué une première lecture sans prendre note afin de me faire un avis général.
- Puis, quelques jours plus tard à tête reposée, j'ai effectué une seconde relecture en prenant note de mes remarques.
Alors, le sujet de ton tutoriel est intéressant et le contenu que tu expliques est tout aussi intéressant. Après ma première lecture, j'ai appris quelque chose sur le sujet (sujet que je connaissais déjà mais pas à un niveau si détaillé) et je n'ai pas eu l'impression de lire de la documentation. Tu expliques le sujet, tu donnes les commandes, tu expliques les commandes et pour finir, tu donnes des pointeurs pour en savoir plus. Donc, globalement, c'est positif et cela pourra aboutir à une publication.
Cependant, il y a quelques remarques que j'ai relevé suite à ma seconde relecture (sachant que je ne suis pas encore à la fin de ma seconde lecture) :
Sur le plan
- La section "Les gestionnaires de paquets" dispose que d'un seul chapitre. Il faudrait les fusionner.
- Dans la section "La concurence : MacPort et Fink", tu mentionnes déjà du vocabulaire Homebrew que tu vas expliquer plus loin dans ton tutoriel. Il faudrait au moins informer le lecteur que ces termes seront expliqués plus loin dans le tutoriel.
- Dans la section "Installer Homebrew", tu mentionnes directement la commande ruby pour installer Homebrew, puis tu expliques les dépendances qui font installés avant et, pour finir, tu redonnes la commande d'installation ruby. Je me mets à la place du lecteur qui aura tendance à exécuter une première fois la commande et qui ne va pas comprendre s'il rencontre une erreur.
Vocabulaire
Tu mentionnes les termes Frameworks, Bundles et Git sans aucune explication alors que le lecteur ne connait pas forcément ces termes et ce qui se cache derrière. Il faudrait soit faire des notes en bas de page, soit donner des liens vers une ressource qui explique ces termes.
Ponctuation
Globalement, il faut que tu vérifies la fin de chaque phrase/paragraphe pour voir si tu as bien une ponctuation. J'avais commencé à les noter mais à partir d'un moment j'ai arrêté.
Orthographe
- Un paquet est une entité qui contient toutes les informations
- De télécharger 15Go de données
- "A la fabrication de bières" ou "à la fabrication de la bière"
- On ne comprends pas tout de suite que : « J'utiliserai pour ma part de manière indifférente les termes paquets, recettes ou logiciel pour désigner ce que l'on cherche à installer. Une recette peut fournir différentes choses : » référence recettes et pas tout le tableau récapitulatif sur l’univers de la bière.
- Il existe aussi une interface
s web pour effectuer des recherches dans la liste des recettes.
- pour chacun des binaires installés
- c’est-à-dire les recettes qui sont une dépendance d’un
e autre paquet
- Il faut commencer par bru remove foo afin que les dépendances inutiles
Il y a déjà de quoi corriger, je termine ma lecture très prochainement !
