Crucible : la revue de code industrielle


Publié par
Sébastien Delcoigne

12 juillet 2017

Les revues de code c’est bon, mangez-en !® Elles sont un outil essentiel à l’obtention d’un code de qualité et occupent également un grand rôle dans la diffusion des savoirs sur le code au sein de l’équipe de développement. C’est pourquoi toute équipe agile qui se respecte les intègre instinctivement dans ses processus. Le besoin de revue de code peut également émaner de contraintes extérieures liées par exemple à des impératifs réglementaires ou de certification. La clé du succès passe en partie par des outils performants qui apportent des solutions efficaces et non des contraintes additionnelles. Cet article propose une visite guidée des points forts de cette application mal connue qui mérite pourtant de l’être : Atlassian Crucible,une solution complète pour traiter l’activité de revue de A à Z.

Concevez finement vos processus de revue

Les étapes d’une revue dans Crucible sont fixes : Draft, Opened, Summarized, Closed ou Abandoned.

workflow

La configuration des processus se joue au niveau des schémas de permissions, notion familière aux utilisateurs de JIRA, qui permettent de configurer au travers une quinzaine de propriétés la manière de conduire les revues pour un projet donné. Elle sert à indiquer quels utilisateurs, groupes d’utilisateurs ou rôles sont autorisés à effectuer les différentes étapes d’une revue. Qui peut créer des revues ? Qui peut les consulter, les approuver, les fermer ? La configuration de projet, quant à elle, sert à préciser les utilisateurs ou groupes d’utilisateurs par défaut sur certains rôles et éventuellement à restreindre les personnes pouvant participer aux revues.

Traitez efficacement les sujets

Le tableau de bord est le point d’entrée de l’application. Il donne en un seul coup d’œil la liste des revues en cours, leur état actuel, les délais de traitement ainsi que l’activité des autres relecteurs. Il permet au relecteur d’entrer rapidement dans ses sujets et au chef de projet d’avoir une vue d’ensemble de l’activité en cours.

fecru_dashboard_fr

Travaillez directement en contexte

Fini les tableurs ou autres documents texte à retrouver sur le réseau et à ouvrir en parallèle des éléments à revoir. Les commentaires de revue sont directement contextualisés avec les fichiers eux-mêmes et permettent de caractériser simplement l’objet de la remarque, sa criticité éventuelle et son type.

FeCru-review-comment_EN

Le dialogue qui peut advenir est également contextualisé, de sorte que les futurs intervenants pourront reprendre le fil de la discussion sans effort.

FeCru-review-comment-discussion

Suivez confortablement l’état de l’activité

Définissez le périmètre et les objectifs de vos revues, gérez ensuite les remarques et les actions qui en découlent avec la vue de relecture qui permet d’avoir rapidement une idée de l’état d’avancement d’une revue et de ses différents intervenants.

fecru_review_overview2

Cette vue à la fois simple à lire mais dense en informations permet notamment d’afficher :

  • Le nombre de commentaires par fichier
  • Le nombre de commentaires par intervenant
  • Le pourcentage de relecture par intervenant
  • Le nombre de remarques nécessitant une prise en compte
  • Les fichiers déjà revus par l’utilisateur en cours et ceux qui restent à analyser

Intégrez les revues dans le processus global de vos projets

Liez JIRA et Crucible ensemble pour intégrer pleinement les revues avec les demandes : créez des demandes ou des sous-tâches et résolvez-les depuis des commentaires de revue, vérifiez le déroulement des revues depuis les demandes JIRA, définissez des déclencheurs de workflow automatiques depuis des événements de revue, etc. La liste des possibilités s’accroît à chaque nouvelle version des outils.

FeCru-createissue2

Pas encore satisfait ? Boostez encore plus vos possibilités à coup d’add-ons !

Comme toute application Atlassian, Crucible bénéficie également de l’inventivité des développeurs de la communauté, qui proposent tous les jours de nouveaux add-ons pour améliorer vos outils.

Pourquoi créer des revues à la main quand vous pouvez les automatiser ? Review Creator d’Atlassian Labs vous permet de créer automatiquement de nouvelles revues ou d’enrichir des revues existantes à partir de la détection de nouveaux commits.

Balisez le travail de vos relecteurs avec Crucible File Tagging d’Atlassian Labs en labellisant par avance les fichiers prioritaires à traiter.

La qualité vous tient tellement à cœur que vous avez mis en place Sonar ? Alors ajoutez les rapports Sonar directement sur le code avec Cruson.

La Marketplace d’Atlassian contient sans aucun doute des add-ons qui peuvent vous intéresser. Et dans le cas contraire vous pouvez toujours développer les vôtres (ou nous demander de le faire (wink)).