Il est de notoriété publique que la majorité des informaticiens n’aime pas rédiger de la documentation. C’est donc un domaine en manque de contributeurs!

Le projet de documentation Debian (DDP pour les intimes) est le point central qui essaie de fédérer toutes les initiatives de création de documentation autour de Debian. Mais il suffit de jeter un oeil sur la liste de diffusion associée (debian-doc@lists.debian.org) pour se rendre compte que l’activité du projet est minime.

Pourtant, de nombreux documents sont sous sa responsabilité. Certains concernent les utilisateurs, d’autres plutôt les développeurs, et les derniers sont regroupés dans une catégorie « divers« . Chaque écrivain (technique) en herbe peut y trouver son bonheur!

Pour le moment, la majorité des documents sont rédigés en DebianDoc SGML (paquet debiandoc-sgml) et sont gérés dans un dépôt cvs. Les documents qui sont empaquetés ont souvent une liste de bogues associés (ex: apt-howto, developers-reference, debian-history…). Cette dernière contient souvent des idées d’amélioration qui peuvent constituer un point de départ pour contribuer. Armé de votre éditeur de texte préféré, de cvs pour télécharger la dernière version des sources, et de diff pour créer des patchs, vous pouvez vous lancer dans l’aventure.

Il ne faut pas hésiter à se présenter sur la liste de diffusion, à mentionner sa volonté de participer (en précisant les sujets qui vous intéressent plus particulièrement), et – bien entendu – à poser des questions lorsque vous vous êtes bloqués.

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.

En reportant le bogue #428797 sur le paquet xscreensaver, il m’est apparu que le paquet avait beaucoup (trop) de bogues ouverts. J’ai donc regardé de plus près l’état du paquet et j’ai découvert qu’une nouvelle version majeure du logiciel était disponible (5.x contre 4.x dans unstable).

J’ai alors soumis un deuxième bogue (#428798) demandant au mainteneur de mettre en paquet la dernière version. Je lui ai fait remarquer que l’état du paquet n’était pas génial et qu’il devrait s’y remettre ou au moins demander de l’aide…

Dans la même journée, le mainteneur se sentant coupable de négligence m’a demandé comment « rendre la main » puisqu’il ne souhaitait plus continuer de maintenir le paquet. Je lui ai indiqué, et je l’ai incité à envoyer un message à debian-devel pour trouver un mainteneur plus rapidement. Aussitôt dit, aussitôt fait.

Quelques temps après, Jose Luis Rivas adoptait le paquet (avec David Moreno Garza pour le sponsoriser). L’envoi de la version 5.03-1 a suivi peu de temps après et fermait 20 bogues!

Cout de l’opération: 2 bogues et 2 mails envoyés. Bénéfice: 20 bogues fermés et un mainteneur actif pour le paquet.

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.

Dans le bogue #313317, Jean-Christophe Dubacq a fourni un patch afin qu’une session SSH préserve correctement la variable d’environnement LANG.

Malheureusement le paquet OpenSSH a accumulé les bogues au fil du temps, et les mainteneurs n’ont visiblement pas le temps de rattraper le retard accumulé. Au lieu d’attendre indéfiniment que le mainteneur Debian traite ce bogue précis, Jean-Christophe est allé sur le site web de OpenSSH afin de trouver où l’on peut signaler les bogues.

Après avoir lu les instructions, il s’est rendu sur leur Bugzilla et s’est créé un compte. Ensuite il a pu soumettre un nouveau bogue (après avoir vérifié que ce bogue n’est pas déjà répertorié). Accompagné du patch, il est probable que le bogue soit traité plus rapidement… du côté Debian, il a pensé à marquer le bogue comme « forwarded » en pointant vers l’adresse du bogue amont.

D’une manière générale, avant de soumettre un bogue en amont, il faudrait s’assurer que le bogue ne soit pas spécifique à Debian. En regardant le paquet source Debian (apt-get source openssh), il est souvent possible de voir si le paquet diverge beaucoup ou pas en inspectant le fichier .diff.gz (avec zless par exemple). Un paquet qui ne diverge pas n’aura pas de changements dans les fichiers sources, il rajoutera juste des fichiers dans le sous-répertoire debian. L’exception qui confirme la règle est l’ajout de fichiers dans debian/patches/. Ces derniers sont des modifications qui seront appliquées dynamiquement à la compilation. Si le paquet diverge sensiblement, et que vous n’êtes pas capable de dire si ces changements ont une influence ou non sur le bogue qui vous intéresse, dans ce cas il vaut peut-être mieux s’abstenir de soumettre le bogue en amont. Si vous le faites malgré tout, signalez impérativement l’incertitude sur l’origine du bogue.

Alternativement à tout cela, il est possible de relancer le mainteneur Debian. Dans le cas de OpenSSH les mises à jour sont fréquentes, le mainteneur est donc disponible, un simple mail poli et courtois peut suffir à débloquer la situation. Demandez-lui des nouvelles du bogue, informez le que vous êtes prêt à faire suivre le bogue en amont s’il pouvait vous confirmer que le bogue n’est pas spécifique à Debian.

C’est un bon moyen pour commencer une carrière de trieur de bogues. 🙂

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.

Nous sommes nombreux à apprécier Debian, mais mis à part le bouche à oreille qui marche assez bien, il n’y a pas beaucoup de promotion de notre distribution préférée. Trop souvent Debian est présentée comme une distribution difficile d’accès et les préjugés ont la vie dure.

Il y a donc un formidable travail d’information et de promotion à faire. Et les développeurs Debian, aussi doués soient-ils techniquement, ne sont décidément pas très forts pour promouvoir leur distribution préférée. Les annonces de presse (« Press Release ») émanant du projet se comptent sur les doigts d’une main… pourtant on est tous d’accord sur le fait qu’il en faudrait plus.

L’équipe debian-publicity

Si vous êtes à l’aise en anglais, le mieux est de rejoindre l’équipe debian-publicity et de s’abonner à sa liste de diffusion. N’hésitez pas à proposer des annonces et des nouvelles en les envoyant à la liste. Commentez et corrigez les propositions des autres (le jour où il y en aura ;-)). Vous nouvelles pourront soit être intégrées dans times.debian.net soit publiées sur debian-news@lists.debian.org par Alexander Schmehl ou Martin Joey Schulze.

La promotion en français

Si l’anglais n’est pas votre tasse de thé, vous êtes laché dans le vide… je ne connais pas d’équipe francophone dont le but soit la promotion de Debian en France (hormis l’association Debian France peut-être).

Défrichons donc le terrain: il y a une liste de diffusion debian-news-french qui véhicule les nouvelles traduites en français. Les modérateurs sont très compréhensifs et accepteront volontiers de publier des nouvelles originales en français. Charge à vous de rédiger les premières annonces… pour les faire relire, je suggère de les envoyer à debian-devel-french. La liste ne sert que rarement à discuter de technique, et elle fédère un grand nombre de contributeurs francophones.

Promouvoir ailleurs

J’ai cité essentiellement les médias employés par Debian pour véhiculer les annonces et les nouvelles, mais la force d’une communauté c’est aussi son aspect décentralisé. Tout ne doit pas nécessairement passer par le projet lui-même. Bloguez sur Debian, créez des sites indépendants traitant de Debian, participez à ces sites…

Exercice pratique

Rédigez une courte introduction présentant cette initiative et publiez là sur votre blog ou sur votre site web! Faites circuler l’information afin de susciter des vocations de contributeurs au sein de la communauté des utilisateurs de Debian.

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.