Guide pour la maintenance

Statut de cette page: RFC

Les recommandations de ce document sont proposées pour discussion par la communauté. Pour apporter un commentaire, éditez cette page à la section "Commentaires" ci-dessous, intervenez sur le Slack ou ouvrez une issue sur le dépôt.

Vos objectifs en tant que mainteneur

• réduire le temps qui s'écoule entre la survenue d'une proposition de contribution qualifiée, et l'intégration de cette contribution dans OpenFisca France
• s'assurer que les contributions ne dégradent pas la qualité du code d'OpenFisca France, prise dans sa dimension systémique
• partager avec les contributeurs des éléments de connaissance technique, fonctionnelle et de culture générale du code afin de les rendre plus autonomes
• formaliser l'apprentissage issu de chaque traitement d'une demande de support ou d'une PR, afin de le partager plus largement dans la communauté

Comment accompagner une issue

Afin de faciliter la prise en compte d'une issue par la communauté, il s'agit de :

• remercier l'intervenant pour son dépôt de l'issue
• s'assurer que le problème est bien décrit et reproductible (ceci est facilité par le template d'issue)
• expliciter les jalons éventuels de l'intervenant ayant ouvert l'issue
• faire explicitement appel aux personnes spécialisées dans le domaine lorsque cela est nécessaire

Cas des issues roadmap d'une institution

Certaines issues comprennent dans leur titre le terme roadmap. Celles-ci ont pour objet d'expliciter les champs d'action principaux d'une équipe et les jalons. Exemple : openfisca-france#1404

Il n'est pas attendu de traitement de ce type d'issue par les mainteneurs si ce n'est la prise en compte des délais dans la priorisation de leurs activités.