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 :