Je pense que vous devez compter sur le fait que les gens sont capables de penser par eux-mêmes. Vous pouvez fournir des directives de base, comme celles que vous avez décrites, mais au final, les gens doivent les comprendre pour les suivre.
Voici un extrait de mes meilleures pratiques recommandées pour le contrôle de version :
Toujours écrire un commentaire quand on commet quelque chose dans le référentiel. Votre commentaire doit être bref et précis, décrivant ce qui a été modifié et éventuellement pourquoi. Si vous avez effectué plusieurs modifications, écrivez une ligne ou une phrase sur chaque partie. Si vous vous retrouvez à écrire une très longue liste de changements, envisagez de diviser votre livraison en plus petites parties, comme décrit précédemment. Faire précéder vos commentaires d'identifiants comme Fix ou Add est un bon moyen d'indiquer le type de changement que vous avez effectué. Cela facilite également le filtrage ultérieur du contenu, soit visuellement, par un lecteur humain, soit automatiquement, par un programme.
Si vous avez corrigé un bogue spécifique ou mis en œuvre une demande de changement spécifique, je recommande également de faire référence au numéro du bogue ou du problème dans le message de livraison. Certains outils peuvent traiter cette information et générer un lien vers la page correspondante dans un système de suivi des bogues ou mettre automatiquement à jour le problème en fonction de la livraison.
Voici quelques exemples de bons messages d'engagement :
Changed paragraph separation from indentation to vertical space.
...
Fix: Extra image removed.
Fix: CSS patched to give better results when embedded in javadoc.
Add: A javadoc {@link} tag in the lyx, just to show it's possible.
...
- Moved third party projects to ext folder.
- Added lib folder for binary library files.
...
Fix: Fixed bug #1938.
Add: Implemented change request #39381.
D'après mon expérience, vous devez suivre les gens et leur donner des instructions chaque fois qu'ils ne suivent pas les règles de commit. Vous pourriez bien sûr implémenter un script pour faire respecter certaines des règles (comme le préfixe et le référencement des bogues), mais cela n'attrapera pas les personnes paresseuses qui ne prennent pas la peine d'écrire quelque chose de significatif. Je pense qu'il est important d'expliquer pourquoi vous voulez ces conventions et comment elles bénéficieront à l'équipe de développement.
La création d'une liste d'envoi de courriels et le suivi des messages qu'elle contient est un bon moyen de savoir ce que font les gens. Si quelqu'un commet quelque chose sans message satisfaisant, vous le saurez et pourrez le lui dire. Je suppose que c'est la même chose que pour les conventions de codage, pour qu'elles aient du succès, quelqu'un doit en assurer le suivi.
