#use wml::debian::template title="La documentation" #use wml::debian::translation-check translation="1.51" maintainer="Mickael Simon"

La documentation est une partie importante de tout système d'exploitation car elle englobe les manuels techniques qui décrivent le fonctionnement et l'utilisation des programmes. Dans le cadre de la création d'un système d'exploitation libre de haute qualité, le « Projet Debian », bien loin de négliger cette partie documentaire, ne ménage pas ses efforts pour en fournir à tous ses utilisateurs, sous une forme facilement accessible.

La plupart de la documentation disponible avec Debian est issue de la documentation écrite pour le système GNU/Linux. Il existe, toutefois, des documents spécifiques à Debian, classés selon les catégories suivantes :

Les manuels

Comparables à des livres, les manuels décrivent des sujets précis de manière très détaillée.

Les manuels spécifiques à Debian

Manuels pour les utilisateurs

Manuels pour les développeurs

Manuels divers

La liste complète des manuels et des documents Debian est disponible sur les pages web du Projet de documentation Debian.

Il existe également plusieurs manuels destinés aux utilisateurs et écrits pour Debian GNU/Linux, disponibles sous la forme de livres imprimés.

Manuels pour GNU/Linux en général

Les documents et manuels Linux les plus populaires sont le Linux Installation and Getting Started, le Guide de l'utilisateur Linux, le Guide de l'administrateur réseau, le System Administrator's Guide.

La documentation Linux est coordonnée grâce aux efforts du Projet de documentation Linux (LDP en anglais). Vous trouverez l'intégralité des manuels du LDP sur leur page web, ainsi que plein d'autres documents, sous une forme électronique et imprimée.

Les HOWTO

Les documents HOWTO, comme leur nom l'indique en anglais, décrivent comment faire quelque chose et ils couvrent habituellement un sujet bien spécifique.

Parmi les HOWTO Linux les plus importants il y a :

Vous pouvez également les installer sur votre propre machine grâce aux paquets doc-linux-text et doc-linux-html. # TODO: make a note about the translated doc-linux-* packages...

Les FAQ

Le sigle FAQ signifie foire aux questions. Une FAQ est un document qui répond aux questions les plus fréquemment posées.

La FAQ Linux contient des informations concernant Linux en général.

Les questions spécifiques à Debian sont traitées dans la FAQ Debian.

Veuillez consulter l'index des FAQ LDP pour plus d'information.

Les autre documents plus concis

Les documents suivants fournissent des instructions plus concises et rapidement consultables :

les mini-HOWTO
Comme leur nom l'indique en anglais, ce sont de petits HOWTO. Ils sont d'habitudes plus courts et plus laconiques que les HOWTO habituels.
les pages de manuel
Traditionnellement, tous les programmes Unix sont documentés avec des pages de manuel, accessibles à travers la commande man. Elles ne sont habituellement pas adressées aux débutants.
les divers fichiers README
Les fichiers README (lisez-moi) sont aussi très courants -- ce sont de simples fichiers textes décrivant un sujet unique, d'habitude un paquet. Vous en trouverez beaucoup dans le sous-répertoire /usr/share/doc/ de votre système Debian.
# TODO: the link to installguide is probably misplaced

Vous pourriez également être intéressés par le Guide d'installation pour Debian 2.2, qui est un support technique en ligne.

Si vous avez consulté les ressources précédentes et que vous n'avez toujours pas trouvé de réponses à vos questions ou de solutions à vos problèmes concernant Debian, jetez un coup d'½il à notre page support.