Choisir le bon outil de revue de code pour votre organisation

par Phil Miller

‍

Il est bien établi que les revues de code sont une partie importante de toute organisation saine de génie logiciel. Nous avons même récemment abordé des conseils pour améliorer vos revues et couvert tous les outils populaires qui les alimentent. 

Compte tenu de tout cela, examinons comment choisir le meilleur outil pour votre organisation, aujourd'hui et à l'avenir. 

‍Lebut ici n'est pas de vous dire quel outil choisir, mais de vous donner un cadre pour poser les bonnes questions afin que vous puissiez décider par vous-même .

Vos besoins d'abord

La première chose à prendre en compte est la taille actuelle de votre organisation d'ingénierie. Vos besoins seront très différents selon que vous êtes en phase de démarrage, de taille moyenne ou d'entreprise. Vous devez également tenir compte de la taille de votre (vos) base(s) de code, du nombre de contributeurs et du fait que vous disposez ou non de ressources internes qui seront chargées de l'infrastructure connexe. 

Ensuite, réfléchissez à l'état actuel de l'examen du code dans votre organisation. Quels sont vos défis actuels ? Procédez-vous à un examen formel du code aujourd'hui, ou est-ce plus une simple formalité ? Si vous ne procédez pas à des révisions, quels risques cela pose-t-il et comment cela évoluera-t-il avec le temps ? 

Enfin, pensez à votre feuille de route technique. Les outils d'examen du code contribueront-ils à la réalisation de certains éléments de cette feuille de route ? Par exemple, si vous avez promis à un gros client que vous serez conforme à la norme SOC 2 d'ici la fin de l'année, cela peut influencer le type d'outils et de processus de révision du code. 

Caractéristiques principales

Une fois que vous avez défini vos besoins organisationnels, examinez les caractéristiques requises en termes de.. : 

Intégrations: 

• Quels sont les outils tiers indispensables à votre processus de développement ?

Personnalisation: 

• Quelle est l'importance de la personnalisation et de l'extensibilité du flux de travail ? 

Expérience de l'utilisateur

• De quels types d'appareils et d'interactions votre équipe aura-t-elle besoin ? 

Collaboration et communication

• Comment tout cela s'inscrit-il dans votre culture d'entreprise en matière d'interaction entre les membres de l'équipe ? 
• Quels sont les éléments de collaboration les plus importants ?

Sécurité et conformité

• Quels sont vos besoins en termes de contrôle d'accès, de permissions, d'authentification, etc.
• Cet outil est-il compatible avec les certifications qui constituent une exigence légale ou réglementaire pour votre organisation ? 

Évaluer les solutions

Une fois que vous aurez apporté les premières réponses aux questions ci-dessus, revenez sur notre article précédent concernant les outils de révision de code. Réfléchissez à celui qui vous conviendrait le mieux compte tenu de toutes vos considérations. 

Il est maintenant temps de planifier la manière d'évaluer efficacement le(s) outil(s) que vous avez choisi(s). Il convient de noter qu'il est très difficile (voire impossible) de tester plusieurs solutions de revue de code sur le même référentiel. C'est pourquoi vous pouvez envisager plusieurs essais consécutifs ou des essais parallèles sur différents dépôts. Assurez-vous simplement que vous les évaluez de la même manière. 

Pour y parvenir efficacement, il convient de tenir compte des éléments suivants : 

Démonstrations et essais

• La durée de l'essai est-elle suffisante pour évaluer véritablement la solution ? (par exemple, pouvez-vous faire au moins un sprint/cycle ?) 
• L'essai est-il suffisamment permissif en termes d'accès aux fonctionnalités ? (Par exemple, êtes-vous en mesure d'accéder à toutes les fonctionnalités dont vous avez besoin ou sont-elles protégées par un paiement ?) 

Examens et études de cas

• Existe-t-il des critiques ou des témoignages d'organisations similaires à la vôtre ? Si ce n'est pas le cas, pouvez-vous demander une référence à un client existant qui a des besoins similaires ?
• Quelles sont les études de cas ou les livres blancs disponibles ?

Prix et licences 

• Avez-vous besoin d'une licence perpétuelle ou d'un abonnement ? Quel est l'impact sur les plans d'assistance ?
• Comment vos besoins en matière d'intégration, d'automatisation et d'infrastructure affecteront-ils le coût total ? 
• Combien cela coûtera-t-il de plus lors du renouvellement de la licence/de l'abonnement, compte tenu de la croissance prévue de vos effectifs ? 

Lancer l'appel et le déployer

Vous avez fait des démonstrations, un essai (ou deux) et vous êtes prêt à vous engager. Il est maintenant temps de vous assurer que vous disposez d'un plan efficace pour déployer cette solution au sein de votre organisation. Si tout va bien, vous vous êtes occupé de la mise en place de toutes les intégrations et de tous les flux de travail au cours de la période d'essai, ce n'est donc pas un problème à ce stade. Vous pouvez vous concentrer sur la formation de vos équipes et leur apprendre à effectuer une revue de code efficace avec votre nouvel outil. 

Comme vous venez (espérons-le) de terminer une évaluation pendant la phase d'essai, vous devriez avoir une idée de vos indicateurs clés de performance et de vos mécanismes de retour d'information. C'est le moment idéal pour les intégrer régulièrement dans votre processus global et vos rapports. Lorsque vous évaluez en permanence quelque chose comme les revues de code, vous disposez toujours d'un indicateur de ce qui fonctionne et de ce qui ne fonctionne pas. Ainsi, si vous devez réévaluer votre ensemble d'outils à l'avenir, vous disposerez déjà d'une base très solide pour le faire. 

Conclusion

Nous espérons que cela vous fournira un cadre solide pour évaluer votre outil de revue de code aujourd'hui et à l'avenir. Si vous subissez actuellement le risque commercial lié à l'absence de revues, le meilleur moment pour commencer est aujourd'hui. 

Si tout cela vous semble un peu insurmontable, ne vous inquiétez pas, vous n'êtes pas seul. Essayer de forcer un changement organisationnel pour quelque chose d'aussi fondamental que les revues de code peut être une tâche monumentale. Si vous voulez essayer quelque chose qui peut améliorer vos revues aujourd'hui, nous avons construit le Korbit AI Mentor pour cette raison précise. Essayez-le et dites-nous ce que vous en pensez ! 

‍