Differences between revisions 2 and 3
Revision 2 as of 2012-11-04 12:16:32
Size: 7444
Editor: PaulWise
Comment: snapshot is an official service now
Revision 3 as of 2013-05-17 19:35:32
Size: 7447
Comment: sync with English master
Deletions are marked like this. Additions are marked like this.
Line 66: Line 66:
 * http://www.backports.org - Backport pour la distribution stable  * http://backports.debian.org - Backport pour la distribution stable

Translation(s): English - Français - Italiano


Debian est une distribution faite de milliers de logiciels (libres). .

Cette page concerne la documentation officielle de Debian.

Il y a d'autres sources d'information sur Debian

La documentation de Debian

Pour les utilisateurs

Les incontournables pour les utilisateurs de Debian :

Bien d'autres documentations sur Debian sont disponibles sur la page documentation.

Pour le moment, Debian n'a pas de manuel de l' administrateur système.

Pour les contributeurs

Les incontournables pour les utilisateurs de Debian :

On trouve l'essentiel de la documentation pour les développeurs de Debian (et pour les responsables de paquets) à l'adresse : le coin du développeur Debian.

Sites officiels du projet Debian

Le projet Debian est doté d'une constitution et d'une structure organisationnelle.

Sur Debian.org le site officiel de Debian, on trouvera une section dédiée à la documentation.

Forum

Promotion, développeurs, informations interne

Wiki

Wikis sur Debian

Livres

Sur le site de Debian, on trouvera la liste de nombreux ouvrages, libres ou non

D'autres livres peuvent être listés ci-dessous.

Instant Messaging

Il y a des canaux IRC officiels de Debian.

On peut utiliser aussi Jabber

Documentation sur les programmes

Chaque programme possède sa documentation propre.

Sous Debian (comme sur Unix), la documentation d'un programme consiste habituellement en une (ou plusieurs):

  • page de manuel (saisir man suivi du nom de la commande).

  • un fichier README, fourni par les développeurs (un fichier texte placé dans /usr/share/doc/nom du paquet/README)

  • un fichier README.Debian, fourni par le mainteneur du paquet Debian (un fichier texte placé dans /usr/share/doc/nom du paquet/README.Debian)

  • Les programmes dotés d'une interface graphique (Gnome, KDE...) possède en général une page d'aide (accessible par Menu > Aide).

  • Certains programmes fournissent leur documentation sous la forme d'une page html ou info.

Description des paquets

Dans la description des paquets, on trouvera des informations utiles : une courte description du paquet, un lien vers le site original, la listes des fichiers inclus et d'autres choses encore. On accède à la description du paquet par l'url http://packages.debian.org/<nom du paquet>. Sinon, on peut essayer "aptitude show $PKG" (il faudra peut-être d'abord faire "apt-get update && apt-get aptitude && aptitude update").

Un des meilleurs endroit pour trouver de l'aide sur un paquet ou une application reste les documents que l'on trouve dans /usr/share/doc/<nom du paquet> (et en particulier README.Debian). C'est une documentation rédigée par les developpeur ou les mainteneurs du paquet. Elle est en général concise, mais elle informe sur les problèmes courants et leur solution, sur les nouvelles fonctionnalité et sur les bogues résolus.

Système de suivi de bogues

On trouve souvent la solution des problèmes dans les réponses au signalement des bogues. Il existe un moteur de recherche sur les rapports de bogues à la page http://bugs.debian.org. N'oubliez pas, si vous voulez chercher dans les bogues archivés (les plus anciens) anciens de choisir l'option "bogues archivés". Si vous souhaiter trouver les bogues d'un paquet particulier, utilisez http://bugs.debian.org/<nom du paquet>.

Contribuer à la documentation

L'essentiel de la documentation Debian est disponible sur la page du projet de documentation de Debian

Si vous vous sentez concernés, vous pouvez lire les listes de discussions :

  • debian-www

  • debian-doc

  • {i} C'est un logiciel libre, vous pouvez tous contribuer à l'amélioration de la documentation
    (c'est-à-dire que vous n'avez pas écrire votre propre manuel !)
    .

Voir aussi