Les manuels de lecture et les wikis peuvent sembler fastidieux, mais c'est quelque chose que j'aime chez Linux. Cela peut sembler étrange, mais la façon dont les documents Linux et Unix sont conçus, c'est beaucoup moins une corvée qu'avec d'autres logiciels.
La documentation Linux est en fait informative
La meilleure chose de la documentation Linux est que vous pouvez le lire et avoir une idée de ce que vous faites. La documentation de la plupart des programmes commerciaux s'adresse aux utilisateurs ordinaires, tandis que les documents Linux ont tendance à assumer un public plus technique, comme le Arche wiki. Cela signifie que beaucoup de fichiers d'aide ou d'articles de base de connaissances ont tendance à lésiner sur les détails.
La documentation Linux a tendance à vous informer d'un programme, de ce qu'elle fait et de la façon dont vous pourriez réparer les choses si elles se trompent. Je pense que cela reflète les différents publics de Linux vs autres systèmes d'exploitation. La grande majorité des utilisateurs de Linux ont tendance à être techniques, ou du moins les personnes souhaitant devenir plus techniques.
En rapport
J'ai exploré les plus grandes pages d'homme sur Linux, voici ce que j'ai appris
Ces manuels deviennent grands.
Étant donné que les personnes qui lisent les documents auront tendance à s'appuyer davantage sur le côté technique, et les auteurs ne risqueraient pas de divulguer des secrets commerciaux, ils peuvent expliquer comment le logiciel fonctionne réellement dans leur code. Cela signifie que votre temps passé à lire des manuels, quand vous le devez, sera bien dépensé.
La documentation est rafraîchissante et honnête
Je trouve qu'il y a beaucoup de « discours heureux » dans la documentation des logiciels propriétaires et basés sur le Web, du moins lorsque je peux l'obtenir en premier lieu. Ils semblent nier qu'il y a un problème possible avec leur logiciel. Toute reconnaissance d'un problème ne doit probablement provenir que d'un billet d'assistance au service client. La réponse que j'ai tendance à obtenir de ces personnes est généralement aussi informative que leur documentation. Autrement dit, pas beaucoup.
En revanche, Linux Docs vous fera savoir si quelque chose est cassé. Il y a généralement un message en haut d'une page Wiki officielle ou d'une page de documentation. Cela peut sembler frustrant si vous n'y êtes pas habitué, mais tous les logiciels ont des bogues. Les développeurs open source n'ont pas de raison de les cacher.
En rapport
5 raisons pour lesquelles je change mon logiciel pour les alternatives open source
Open Source est l'endroit où l'utilisation de produits gratuits ne signifie pas que vous êtes le produit!
Cette autocritique s'étend même à la documentation elle-même. Comme lié par le livre de 1989 La vie avec Unix Par Don Libes et Sandy Ressler, une section Bugs dans un utilitaire BSD se lit: « Cette page manuelle est déroutante. » Dans la version suivante, ce message a été mis à jour vers « Cette page manuelle est toujours déroutante ».
Les documents sont souvent écrits par des développeurs
Une autre différence clé de la documentation Linux à partir des logiciels propriétaires est de savoir qui écrit la documentation. Pour la plupart des programmes propriétaires, les manuels sont rédigés par des rédacteurs techniques qui sont retirés du processus de développement et peuvent ne pas être formés au développement de logiciels.
La documentation Linux, en revanche, a tendance à être écrite par les développeurs eux-mêmes. C'est une tradition qui remonte aux pages manuelles d'Unix originales. Cela explique beaucoup sur leur style dense et laconique qui est devenu tristement célèbre dans le monde Linux. Ils offrent toujours certains des meilleurs traits de la documentation Linux: en fait des informations utiles que vous pouvez parcourir ou utiliser la fonction de recherche dans votre téléavertisseur, puis acquérir ce que vous voulez faire. La section « bogues » répertorie également les défauts du programme, où d'autres programmes tenteront de minimiser les problèmes avec leur logiciel.
La forme ultime de la documentation pourrait être le code source, si vous connaissez le langage de programmation utilisé.
Le style de documentation Linux semble moins formel qu'avec d'autres systèmes
Une chose que j'aime dans la lecture de la documentation Linux, c'est que le style a tendance à être beaucoup moins formel qu'avec d'autres logiciels. Même dans les pages manuelles, il y a un style détendu où les développeurs vous disent ce que vous devez savoir. Dans une documentation plus longue comme des livres ou des pages wiki, ils ont également tendance à écrire dans un style conversationnel.
En continuant à ce qu'ils ont écrit sur le Web et dans les livres O'Reilly, beaucoup d'entre eux semblent étonnamment bons dans ce domaine.
Thomas Scoville, dans son essai « Les éléments du style: Unix comme littérature, » Posit que les développeurs UNIX semblent plus à l'aise avec les mots que les utilisateurs d'autres systèmes:
Le fil conducteur était la viande de mots; Une proportion suspecte de mes collègues Unix s'était déjà développée, dans une carrière antérieure, un confort et une maîtrise du texte et des mots imprimés. Ils étaient des lecteurs et des écrivains adeptes, et Unix a joué facilement à ces forces. Unix leur était, dans un certain sens, leur littérature. Soudain, la sur-représentation des polyglottes, des types d'arts libéraux et des lecteurs voraces de la communauté Unix ne semblaient pas si mystérieux et ont ouvert la voie à un problème plus profond: dans un monde de plus en plus dominé par la culture d'images (télévision, films, .jpg fichiers), Unix reste ancré dans la culture du mot.
En tant que « type d'arts libéraux » qui aime aussi la lecture, je suppose que je ne devrais pas être surpris que j'aie gravité vers Linux et d'autres systèmes de type Unix, car une grande partie de ma pensée est orientée texte comme Linux.
Les vieux livres sont toujours utiles
En parlant de littérature, beaucoup de vieux livres Unix et Linux sont toujours utiles, malgré leur âge. Comme mon collègue Corbin Davenport l'a souligné récemment, un livre vintage sur MS-DOS ou Windows serait plus une nouveauté que quelque chose d'utile en raison de la quantité de systèmes que les systèmes ont changé depuis l'écriture du livre.
En revanche, j'ai des livres dans ma collection personnelle qui remontent aux années 1980. Bien que certains des services publics et des environnements aient changé, la plupart des livres sont toujours utiles pour en savoir plus sur les systèmes de type UNIX aujourd'hui. Lorsque j'ai fréquenté la California State University, East Bay dans les années 2000, la section informatique de la bibliothèque était bien stockée avec des livres sur Unix. Ils n'ont probablement jamais ressenti le besoin d'abattre cette section pour la même raison: beaucoup de livres étaient toujours utiles même que certains volumes remontent aux années 80 et plus tôt. Ils avaient même la première édition de Le langage de programmation C par Dennis Ritche et Brian Kernighan de 1978.
Les manuels sont en fait amusants à lire
Une conséquence des traits de la documentation Linux, tels que contenir des informations réelles, écrites par les développeurs, être honnête sur les défauts du logiciel, un style moins formel et l'utilité continue de la documentation, signifie que la lecture est en fait une expérience agréable.
Lorsque je lis la documentation Linux et UNIX, j'ai l'impression d'avoir une conversation en tête-à-tête avec le développeur. Même dans la documentation historique, j'apprends quelque chose sur l'histoire de l'informatique en rencontrant des sources primaires. Je peux lire comment le logiciel était ou est utilisé et quels types de problèmes il était censé résoudre. Je suis un fan de l'histoire de l'informatique, et il peut être amusant de remonter dans le temps, même pendant un certain temps.
La documentation Linux semble peu susceptible de disparaître
Lorsqu'un programme propriétaire publie une nouvelle version, l'ancienne documentation a tendance à disparaître facilement, ou du moins lorsqu'elle prend la peine de créer de la documentation. Si vous devez vous référer aux documents à partir d'une version antérieure, vous pourrez peut-être parcourir la machine Wayback si vous avez de la chance.
Linux et d'autres programmes open-source maintiendront généralement la documentation se référant aux versions antérieures. Un bon exemple de cela serait Documentation Pythonqui vous permet de sélectionner la version à laquelle vous souhaitez que les documents se réfèrent à partir d'un menu déroulant. Ceci est utile car les versions Python fournies avec de nombreuses versions Linux ont tendance à être à l'origine de la dernière version Python.
En ligne ou sur papier, la documentation Linux sera probablement là depuis longtemps à examiner. C'est une des raisons pour lesquelles je vais continuer à y revenir sous une forme. Je peux compter sur la documentation pour être là quand j'en ai besoin.
L'une des raisons pour lesquelles j'aime explorer Linux est qu'il est facile d'obtenir des informations sur le système sous forme de texte. Il y aura de nouvelles choses à apprendre et de nouveaux manuels et livres à lire pour m'occuper pendant des années.
Vous pouvez lire l’article original (en Angais) sur le sitewww.howtogeek.com