Coucou, c'est toujours moi. Si ça continue, je vais avoir l'impression d'être le seul à avoir des commentaires à faire mais bon !
Ca y est, j'ai lu l'article du spécialiste NetBSD. Je ne peux qu'être d'accord avec lui dans le sens où comme je l'ai précisé dans mon premier commentaire (auquel je réponds, quelle ouverture d'esprit !! ), la doc est généré et tributaire des volontaires qui y travaillent et peut donc être dépendante du style de chacun. Cependant, je trouve que pour une doc gratuite faite par des gens qui n'ont pas que ça à faire, c'est quand même pas mal.
Le fait de dire qu'une doc incomplète est tolérable pour un site Web mais pas pour une édition papier montre que l'auteur s'attendait sans doute à un livre digne des éditions O'Reilly. D'autre part, je lui pardonne volontiers de ne pas savoir que la doc est générée à partir des mêmes sources SGML et que de facto, elle est aussi incomplête en version papier qu'HTML.
Sa critique a tout de même l'intérêt de pointer le principal problème du Handbook et de la doc FreeBSD en général, qui est que le manque de rédacteurs implique aussi un manque de relecteurs. Mais comme dirait l'autre à une variante prêt : "laissons le groupe de documentation travailler"
[^] # Re: Le Handbook
Posté par Blackknight (site web personnel, Mastodon) . En réponse à la dépêche FreeBSD Handbook. Évalué à 1.
Ca y est, j'ai lu l'article du spécialiste NetBSD. Je ne peux qu'être d'accord avec lui dans le sens où comme je l'ai précisé dans mon premier commentaire (auquel je réponds, quelle ouverture d'esprit !! ), la doc est généré et tributaire des volontaires qui y travaillent et peut donc être dépendante du style de chacun. Cependant, je trouve que pour une doc gratuite faite par des gens qui n'ont pas que ça à faire, c'est quand même pas mal.
Le fait de dire qu'une doc incomplète est tolérable pour un site Web mais pas pour une édition papier montre que l'auteur s'attendait sans doute à un livre digne des éditions O'Reilly. D'autre part, je lui pardonne volontiers de ne pas savoir que la doc est générée à partir des mêmes sources SGML et que de facto, elle est aussi incomplête en version papier qu'HTML.
Sa critique a tout de même l'intérêt de pointer le principal problème du Handbook et de la doc FreeBSD en général, qui est que le manque de rédacteurs implique aussi un manque de relecteurs. Mais comme dirait l'autre à une variante prêt : "laissons le groupe de documentation travailler"