Admins

Pour l'endroit, j'ai commencé une FAQ là : https://forge.april.org/adminsys/forge.april.org-faq
Les conseils de nommage pour l'intégrer.
Mais l'organisation « adminsys » n'est peut-être pas la meilleur pour ce dépôt. Donc on peut le déplacer.

• attention à ne pas trop contraindre les utilisateurs :
  • des règles trop contraignantes peuvent freiner la participations des utilisateurs,
• la convention Angular présentée sur le site buzin présente de nombreux inconvénients :
  • mélange de deux langues,
  • le préfixe n'est vraiment utile que pour les très gros projets avec plein de modules,
  • super technique alors que :
    • le commentaire est censé être une phrase,
    • difficilement compréhensible par les utilisateurs/visiteurs non techniques,
• en général, les conventions se font projet par projet, mais c'est très bien d'en proposer une par défaut \o/
• il est certain qu'il faut communiquer et encourager à avoir de beaux commentaires de commits <3

• un commentaire de commit est une phrase courte :
  • commencer par une majuscule, finir par un point,
  • ne pas dépasser x caractères (fixer le x),
• utiliser une forme active :
  • le commentaire du commit résume l'action portée par le commit donc pas de forme infinitive,
  • pas besoin de sujet,
  • exemples :
    • Ajout d'un logo.
    • Ajoute un fichier favicon.
    • Amélioration du code dans le module gui (#1234).
    • Add stats help in !help command display (#2910).
    • Refactor onMessage code with hook management.
• si associable à un numéro de ticket, mettre celui-ci à la fin entre parenthèses, exemple : « Blabla (#1234). »

• http://git.savannah.gnu.org/cgit/emacs.git/log/
• https://gitlab.com/mirror1/linux/-/commits/master
• https://forge.april.org/adminsys/hebdobot/commits/branch/Hebdobot-v2.0