Je suis en train de lire la doc et je trouve qu'il y a beaucoup de subjectivité. Il y a beaucoup de remarques, de critiques personnelles.
Ce que j'attends personnellement d'une doc, ce n'est pas des remarques du genre "je vous explique debian car c'est la distribution que j'adore". ou encore "appelée « Sid » (c'est le nom du gamin complètement taré et hyperactif dans Toy Story, c'est pas pour rien, y'a pas de raison qu'il se calme ;)".
Avoir un smiley dans une doc, ça ne fait pas trop "professionnel...
De plus, il y a un peu trop de "je" à mon goût. Si on enlève toutes les phrases de ce type, on aura un document impersonnel, mais il ne restera que le fonctionnel et l'essentiel. Pour ce genre de phrases, je pense que c'est plus dans un blog ou une discussion dans un forum qu'on doit les trouver, et non dans une documentation.
Mais c'est mon point de vue personnel.
En espérant que cette critique est constructive.
Je continue à lire pour faire une critique objective du reste.
# Une critique constructive, j'espère...
Posté par genma (site web personnel, Mastodon) . En réponse au journal Guide Debian : grosse mise à jour. Évalué à 7.
Ce que j'attends personnellement d'une doc, ce n'est pas des remarques du genre "je vous explique debian car c'est la distribution que j'adore". ou encore "appelée « Sid » (c'est le nom du gamin complètement taré et hyperactif dans Toy Story, c'est pas pour rien, y'a pas de raison qu'il se calme ;)".
Avoir un smiley dans une doc, ça ne fait pas trop "professionnel...
De plus, il y a un peu trop de "je" à mon goût. Si on enlève toutes les phrases de ce type, on aura un document impersonnel, mais il ne restera que le fonctionnel et l'essentiel. Pour ce genre de phrases, je pense que c'est plus dans un blog ou une discussion dans un forum qu'on doit les trouver, et non dans une documentation.
Mais c'est mon point de vue personnel.
En espérant que cette critique est constructive.
Je continue à lire pour faire une critique objective du reste.