better-review 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -50,8 +50,8 @@ Puis « Repos suivis » : ajouter des repos (`owner/repo`) ou des orgs / comptes
|
|
|
50
50
|
|
|
51
51
|
## Raccourcis (vue PR)
|
|
52
52
|
|
|
53
|
-
`j`/`k` fichier · `n`/`p` hunk · `]`/`[` thread non résolu · `v` fichier vu (Focus :
|
|
54
|
-
suivant) · `h` hunk vu · `r` répondre · `x` résoudre · `m` continu/focus · `u` côte à côte/unifié ·
|
|
53
|
+
`j`/`k` fichier · `n`/`p` hunk · `]`/`[` thread non résolu · `v` fichier vu puis fichier suivant (Focus : fichier non
|
|
54
|
+
vu suivant), comme le bouton « Vu » d'un fichier · `h` hunk vu · `r` répondre · `x` résoudre · `m` continu/focus · `u` côte à côte/unifié ·
|
|
55
55
|
`t` conversations · `d` description · `f` panneau fichiers · `Maj+S` review · `i` inbox · `Ctrl+K` aller à une PR ·
|
|
56
56
|
`?` aide.
|
|
57
57
|
|
|
@@ -61,24 +61,27 @@ pour le fichier entier. Chaque commentaire part seul ou dans la review en attent
|
|
|
61
61
|
|
|
62
62
|
## Naviguer dans les fichiers
|
|
63
63
|
|
|
64
|
-
Le panneau de gauche (
|
|
64
|
+
Le panneau de gauche (360 px, masquable avec `f`) propose trois vues. **La vue choisie fixe l'ordre des fichiers** :
|
|
65
|
+
le diff, `j`/`k`, le mode Focus et « Vu → fichier suivant » suivent l'ordre affiché (les filtres masquent des lignes
|
|
66
|
+
sans changer l'ordre).
|
|
65
67
|
|
|
66
|
-
| Vue | Ce qu'elle montre
|
|
67
|
-
| ----- |
|
|
68
|
-
| Liste | Fichiers par dossier ou
|
|
69
|
-
| Arbre | Dossiers repliables
|
|
70
|
-
|
|
|
71
|
-
| Liens | Voisinage du fichier courant (ce qu'il utilise → fichier → ce qui l'utilise), liste en ordre de lecture, graphe plein écran |
|
|
68
|
+
| Vue | Ce qu'elle montre (et l'ordre qu'elle impose) |
|
|
69
|
+
| ----- | -------------------------------------------------------------------------------------------------------------- |
|
|
70
|
+
| Liste | Fichiers par chemin, groupés par dossier (A→Z), ou du plus gros au plus petit (Taille) ; barre +/− par fichier |
|
|
71
|
+
| Arbre | Dossiers repliables (sous-dossiers avant fichiers, A→Z ou Taille) avec changements, fichiers vus, threads |
|
|
72
|
+
| Liens | Fichiers en ordre de lecture « base d'abord », nombre d'imports / d'utilisateurs, graphe plein écran |
|
|
72
73
|
|
|
73
74
|
Les liens sont calculés côté serveur sur le contenu complet des fichiers au head de la PR : AST TypeScript pour
|
|
74
75
|
TS/JS (y compris `.js` → `.ts`, `require`, `import()`), règles dédiées pour Python, CSS/SCSS/Less, Go, Java/Kotlin,
|
|
75
76
|
C/C++, Rust, Ruby, Vue/Svelte. Les mentions (nom de fichier en CamelCase, ou nom avec extension, ou chemin) couvrent
|
|
76
77
|
la doc et les autres langages. Les alias `tsconfig` `paths` autres que `@/`, `~/`, `#` ne sont pas résolus.
|
|
77
78
|
|
|
78
|
-
**Ordre «
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
79
|
+
**Ordre « base d'abord »** (vue Liens) : ordre topologique, chaque fichier après ceux qu'il importe ou mentionne, les
|
|
80
|
+
plus utilisés en premier, les cycles départagés de la même façon et les fichiers sans lien à la fin. On relit la PR de
|
|
81
|
+
ses fondations vers ce qui les assemble.
|
|
82
|
+
|
|
83
|
+
**Voisinage** (onglet du panneau de droite, 520 px, quelle que soit la vue de gauche) : graphe du fichier courant, ce
|
|
84
|
+
qu'il utilise → fichier → ce qui l'utilise, avec tous ses voisins ; clic sur un voisin pour l'ouvrir.
|
|
82
85
|
|
|
83
86
|
**Monorepos** : chaque dossier contenant un manifeste (`package.json`, `pyproject.toml`, `setup.py`, `go.mod`,
|
|
84
87
|
`Cargo.toml`, `pom.xml`, `build.gradle`, `composer.json`) est un package ; à partir de deux, l'ordre devient
|
|
@@ -91,7 +94,7 @@ monorepo et les dépendances entre packages (option « Autres packages du monore
|
|
|
91
94
|
packages qui contiennent des fichiers modifiés (et les liens entre eux), le reste en gris. Le graphe de voisinage
|
|
92
95
|
mélange fichiers et packages : à gauche les packages que le fichier importe par leur nom, à droite les packages qui
|
|
93
96
|
dépendent de son package (quand aucun de leurs fichiers n'y figure déjà), mêmes couleurs ; un voisin d'un autre package
|
|
94
|
-
porte le nom de son package, et un clic sur un package modifié ouvre son premier fichier dans l'ordre
|
|
97
|
+
porte le nom de son package, et un clic sur un package modifié ouvre son premier fichier dans l'ordre courant.
|
|
95
98
|
|
|
96
99
|
La description de la PR s'ouvre dans l'onglet « Description » du panneau de droite.
|
|
97
100
|
|