Conseils aux nouveaux responsables de paquets GNU

Si vous êtes le nouveau responsable d'un paquet GNU, qu'il s'agisse d'un paquet proposé par vos soins au projet GNU ou d'un paquet existant que vous avez adopté, vous avez peut-être du mal à savoir par où commencer. Le courriel officiel que vous avez reçu en devenant responsable GNU contient de nombreux détails ; le présent document n'a pas pour objet de le remplacer, mais de le compléter avec des conseils pour vous aider à démarrer.

Bien entendu, ce qui est mentionné ici n'aborde que superficiellement la maintenance d'un paquet GNU. Lisez attentivement le guide du responsable de paquet GNU et les standards de codage GNU. Vous les avez certainement déjà consultés mais ils sont suffisamment fournis pour qu'une relecture soit utile. De plus, quelques contributeurs expérimentés du projet GNU se sont portés volontaires pour répondre aux questions relatives à la maintenance GNU par courriel à <mentors@gnu.org> et <maintainers@gnu.org>.

Les premiers pas des nouveaux responsables de paquet

Ces tâches sont classées par ordre de priorité. Les étiquettes ([Tous], [Nouveaux] et [Adoptés]) indiquent la catégorie de paquets à laquelle chaque tâche se rapporte principalement.

[Tous] Mettez à jour les informations de votre projet sur Savannah. Allez sur la page de votre projet (https://sv.gnu.org/projects/PAQUET, où « PAQUET » est bien entendu le nom de votre paquet) et reportez-vous à Update Public Info dans le menu Main. Vous devez y définir le nom complet du projet et, si nécessaire, en rédiger une description brève ainsi qu'une autre plus détaillée (que vous voudrez bien envoyer toutes deux à <maintainers@gnu.org> pour qu'elles soient placées dans la liste de tous les paquets GNU). Vous devriez également mentionner son état de développement pour donner une idée de la maturité du code. Il est essentiel d'effectuer tout cela si vous avez adopté un paquet, sans quoi il sera marqué comme étant « orphelin ».
[Tous] Occupez-vous des listes de diffusion. Si vous avez un nouveau paquet GNU, vous devez mettre en place au moins un liste de diffusion pour ce paquet sur Savannah (Select features dans le menu principal). Il est fortement recommandé d'en avoir une nommée <bug-PAQUET@gnu.org> ; la création des autres peut attendre que le trafic les justifie. Si vous avez adopté un paquet existant, envoyez un courriel pour vous présenter. Enfin, que les listes de diffusion soient nouvellement créées ou existantes, n'oubliez pas de vous y inscrire vous-même, ceci ne se fait pas automatiquement. (À propos de la gestion des courriels)
[Nouveaux] Mettez en place un dépôt pour votre code source (Select features dans le menu principal) et importez ce que vous avez (Source Code manager dans la section Development Tools pour consulter la procédure). L'expérience a montré que l'autohébergement n'est pas fiable. (À propos des fichiers de sauvegarde)
[Nouveaux] Envoyez votre paquet sur le site FTP de GNU s'il est prêt à publier. (À propos de la procédure de mise en ligne)
[Nouveaux] Créez une page d'accueil GNU pour remplacer le fichier PAQUET.html que les webmestres ont placé dans votre dépôt web (gardez le même nom). Si vous voulez que ce soit rapide et facile, utilisez notre modèle standard. Commentez les parties qui ne s'appliquent pas, comme Downloading et Documentation si votre projet vient tout juste de démarrer ; vous compléterez ultérieurement. Mettez aussi toute la documentation que vous avez déjà dans un sous-répertoire appelé manual. (À propos des pages web.)
[Adoptés] Vérifiez les rapports de bogues existants. Pensez à les consulter si vous avez adopté un ancien paquet. Ils peuvent se trouver à l'un ou l'autre de ces emplacements : le suivi de bogues [bug tracker] de Savannah, une liste de diffusion (les archives mbox sont téléchargeable par HTTPS), ou le serveur debbugs de GNU. (À propos des réponses aux rapports de bogues)
[Adoptés] Contactez les responsables de paquet des distributions. Si vous avez adopté un paquet existant et qu'il est disponible dans les distributions aval, prenez contact avec les responsables de ce paquet. Il est probable qu'ils aient des rapports de bogues non résolus à vous soumettre et peut-être même des correctifs qui devraient être appliqués. Vous pourriez également vouloir vous impliquer dans le gestionnaire de paquets GNU Guix. (À propos des distributions)
[Adoptés] Utilisez le logiciel. Il va sans dire que si vous avez adopté un paquet GNU, vous devez l'utiliser pour avoir un aperçu de son état actuel et prendre la mesure des choses à corriger.
[Tous] Choisissez un travail et commencez à hacker ! Rien ne peut remplacer le temps passé à travailler.

Conseils généraux sur la maintenance de paquets GNU

Faites une première version rapidement. Que votre paquet soit nouveau ou que vous en ayez adopté un ancien, votre priorité numéro un doit être de sortir une première version dès que possible. Si vous avez adopté un paquet, corriger quelques bogues et pousser le tout est suffisant. En fait, il suffit de mettre à jour les fichiers d'infrastructure (par exemple Autoconf/Automake, les modules gnulib, etc.) pour justifier une nouvelle version quand vous prenez en main un paquet. Si votre paquet est nouveau, n'ayez pas peur de sortir une version précoce et non totalement fonctionnelle. Dans tous les cas, la sortie d'une version (avec des annonces appropriées) attirera l'attention sur votre paquet en termes d'utilisateurs potentiels ou même d'autres développeurs. C'est la meilleure façon de faire savoir à tous qu'un vieux paquet a été ressuscité ou qu'un nouveau existe. (À propos de la sortie de versions)
Concentrez-vous en priorité sur la correction des bogues en attente. Un excellent moyen de se familiariser avec une nouvelle base de codage est de corriger des bogues en souffrance afin d'avoir un aperçu du fonctionnement du système. Ajouter des fonctionnalités ne doit pas être votre priorité si des problèmes notables existent déjà. (À propos des ressources pour les développeurs GNU)
N'essayez pas de tout réécrire. Si vous avez adopté un paquet, nous vous recommandons fortement de ne pas chercher à réécrire entièrement le logiciel à partir de zéro. Bien que ce soit toujours tentant et facile à mettre en route, mener cela à terme avec succès demande un effort colossal ; l'expérience a montré que c'est la façon la plus sûre de se démotiver et d'aboutir à une éventuelle (nouvelle) stagnation du projet. Au lieu de cela, concentrez-vous sur des améliorations successives. Une fois que vous vous serez intimement familiarisé avec le paquet, vous serez plus à même d'envisager des changements plus radicaux.
Vous êtes aux manettes ! Vous assurez la maintenance d'un paquet faisant partie de l'ensemble du projet GNU. GNU dépend de vous pour traiter les aspects juridiques, sortir de nouvelles versions, garder à jour les pages web, répondre aux rapports de bogues et communiquer avec les utilisateurs, gérer convenablement les correctifs et tout le reste. Ceci est votre privilège ainsi que votre responsabilité. Merci de nous aider à conserver un ensemble de logiciels stable et actif. Si vous avez des questions ou rencontrez des problèmes, n'hésitez pas à prendre contact avec <maintainers@gnu.org>. (À propos du recrutement de développeurs)
Impliquez-vous. GNU est composé entièrement de bénévoles et votre participation à l'organisation sera ce que vous en ferez ! En tant que responsable de paquet, les communications (comprendre : harcèlement) que vous recevrez de notre part seront limitées. Être actif au sein du projet GNU est un excellent moyen de multiplier les contacts avec des bénévoles ayant le même état d'esprit que vous et d'augmenter votre visibilité auprès d'eux. Si vous découvrez un aspect de GNU dans lequel vous aimeriez vous impliquer, il y aura presque certainement de la place pour vos contributions. (À propos de l'aide à GNU et au logiciel libre)

Pour conclure cette liste avec une dernière répétition : les informations et liens ci-dessus ne sont que des échantillons. Merci de consulter et de (re)lire intégralement l'information à l'usage du responsable de paquet GNU ainsi que les documents des standards de codage GNU ; ce sont des mines de renseignements.

Philosophie GNU

Cette page paraît également appropriée pour donner quelques liens vers les idées de base de GNU et du logiciel libre :