Petit guide de diffox

Installer et demander une revue

Installez l’application GitHub et choisissez les dépôts à examiner. Vérifiez dans la console que votre compte est activé et dispose d’un solde.

Ouvrez une pull request ou marquez un brouillon comme prêt pour la revue. Pour demander vous-même une revue, ajoutez ce commentaire à la pull request :

@diffoxai review

Choisir le fonctionnement des revues

Les paramètres de revue s’appliquent au compte. Dans Dépôts, chaque dépôt peut les hériter, ou choisir son propre mode de revue et son produit.

Dans Dépôts, vous choisissez pour chaque dépôt quand la revue démarre : en mode Automatique, à l’ouverture d’une pull request et à chaque push ; en mode Manuel, uniquement quand vous la demandez.

Si une revue attend, lisez son statut dans la pull request, puis vérifiez le statut du compte, le solde et les limites de revue dans la console. Les brouillons et les paramètres du dépôt peuvent aussi empêcher une revue automatique.

Solde et dépenses

Les reviews sont payées sur le solde de votre compte : le crédit de départ éventuel de votre compte et ce que vous ajoutez. Il n’y a ni abonnement ni recharge automatique.

Accès aux dépôts et vos données

GitHub affiche les autorisations de l’application lors de l’installation. Choisissez uniquement les dépôts à analyser ; vous pouvez modifier ou supprimer cet accès dans GitHub.

Le service lit le contenu des dépôts pour analyser les changements et rédige des commentaires de review. La façon dont votre code est traité pendant une review est décrite sur la page de confidentialité.

La politique de confidentialité explique les données conservées, les prestataires qui les traitent et comment demander leur suppression.

Questions fréquentes

Sur quelles plateformes diffox fonctionne-t-il ? Fonctionne-t-il aussi sur les dépôts privés ?

diffox est une application GitHub et fonctionne aujourd’hui sur GitHub.com ; vous pouvez l’utiliser de la même façon sur les dépôts publics et privés. La prise en charge de GitLab, Bitbucket et GitHub Enterprise Server arrivera plus tard.

Qu’est-ce que diffox ultra, et comment l’utiliser ?

diffox ultra examine la modification avec un modèle plus puissant, plus en profondeur. Pour l’essayer sur une pull request, ajoutez-y le commentaire @diffoxai ultra review. Pour que toutes vos revues passent par diffox ultra, choisissez diffox ultra dans « Revue avec », dans l’onglet Paramètres de la console ; dans Dépôts, vous pouvez aussi le choisir dépôt par dépôt.

diffox refait-il une revue quand je fais un nouveau push ?

Oui ; à chaque push, il ne lit que ce qui est nouveau. Sur une pull request, il fait au plus 5 revues de lui-même, puis s’arrête et l’indique dans la pull request ; pour qu’il continue, il suffit d’écrire @diffoxai review. Vous pouvez changer ce nombre dans l’onglet Paramètres de la console.

diffox utilise-t-il les règles propres au dépôt (AGENTS.md, CLAUDE.md) ?

Oui. Chaque revue lit le fichier AGENTS.md à la racine du dépôt, ou CLAUDE.md s’il n’existe pas, et tient compte de ces règles pendant la revue. Les règles sont lues sur la branche dans laquelle la pull request sera mergée ; une modification du fichier de règles s’applique une fois mergée.

diffox bloque-t-il un merge ?

Non. diffox ne fait qu’écrire des commentaires sur la pull request ; il n’approuve pas et ne demande pas de modifications. Son statut n’est jamais rouge ; votre équipe merge quand elle le décide.

Quels langages de programmation diffox examine-t-il ?

diffox n’est lié à aucun langage en particulier. Python, JavaScript, TypeScript, Java, Go ou un autre : il lit la modification, quel que soit le langage dans lequel elle est écrite.

Dans quelle langue la revue est-elle rédigée ?

En français, anglais, turc, allemand, espagnol ou italien. Vous choisissez la langue dans le champ « Langue des reviews » de l’onglet Paramètres de la console ; sans choix, la revue est rédigée en anglais. Le code, les noms de fichiers et les identifiants ne sont jamais traduits.

Puis-je limiter le nombre de revues ?

Oui. Dans l’onglet Paramètres de la console, vous fixez le nombre de revues par jour et le nombre de revues qui démarrent d’elles-mêmes sur une pull request. Une revue qui atteint une limite n’est pas faite, et la pull request l’indique.

Quels constats diffox publie-t-il ?

diffox choisit lui-même, parmi ce qu’il trouve, ce qui vaut d’être écrit sur la pull request, et l’écrit en commençant par le plus important ; l’importance de chaque constat est indiquée à côté.