Skip to content

Commit cf5169c

Browse files
babu-chclaude
andcommitted
v0.0.2: document auto-fix and bump all three packages
- Add auto-fix sections to all 8 docs locales and to each package README, describing what eslint --fix / rubocop -a / phpcbf will do (template insertion when all three section comments are missing, manual otherwise). - Bump versions to 0.0.2 across all three manifests so the release scripts can publish the auto-fix changes. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 053d923 commit cf5169c

31 files changed

Lines changed: 166 additions & 4 deletions

docs/de/guide/eslint.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,3 +121,9 @@ it('also bad', () => {
121121
expect(x).toBe(y)
122122
})
123123
```
124+
125+
## Auto-Fix
126+
127+
Wenn **alle drei** Sektions-Kommentare fehlen, fügt `eslint --fix` eine `// arrange` / `// act` / `// assert`-Vorlage am Anfang des Testblocks ein. Verschiebe danach jeden Kommentar über den Code, zu dem er gehört.
128+
129+
Andere Fälle (einer oder zwei fehlend, falsche Reihenfolge, leere Sektion) werden nicht automatisch korrigiert — die richtige Einfügeposition hängt von der Absicht des Tests ab, und die Fehlermeldung sagt dir genau, „was" und „wo" einzufügen ist.

docs/de/guide/phpcs.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,3 +89,9 @@ public function testAlsoBad(): void
8989
$this->assertSame($y, $x);
9090
}
9191
```
92+
93+
## Auto-Fix
94+
95+
Wenn **alle drei** Sektions-Kommentare fehlen, fügt `vendor/bin/phpcbf` (der mit PHP_CodeSniffer mitgelieferte Auto-Fixer) eine `// arrange` / `// act` / `// assert`-Vorlage am Anfang der Testmethode ein. Verschiebe danach jeden Kommentar über den Code, zu dem er gehört.
96+
97+
Andere Fälle (einer oder zwei fehlend, falsche Reihenfolge, leere Sektion) werden nicht automatisch korrigiert — die richtige Einfügeposition hängt von der Absicht des Tests ab, und die Fehlermeldung sagt dir genau, „was" und „wo" einzufügen ist.

docs/de/guide/rubocop.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,9 @@ it 'also bad' do
9191
expect(x).to eq(y)
9292
end
9393
```
94+
95+
## Auto-Korrektur
96+
97+
Wenn **alle drei** Sektions-Kommentare fehlen, fügt `rubocop -a` (oder `--autocorrect`) eine `# arrange` / `# act` / `# assert`-Vorlage am Anfang des Blocks ein. Verschiebe danach jeden Kommentar über den Code, zu dem er gehört.
98+
99+
Andere Fälle (einer oder zwei fehlend, falsche Reihenfolge, leere Sektion) werden nicht automatisch korrigiert — die richtige Einfügeposition hängt von der Absicht des Tests ab, und die Offense-Meldung sagt dir genau, „was" und „wo" einzufügen ist.

docs/es/guide/eslint.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,3 +121,9 @@ it('also bad', () => {
121121
expect(x).toBe(y)
122122
})
123123
```
124+
125+
## Auto-fix
126+
127+
Cuando los tres comentarios de sección están **todos ausentes**, `eslint --fix` inserta una plantilla `// arrange` / `// act` / `// assert` al inicio del bloque de test. Luego solo tienes que mover cada comentario sobre el código que le corresponde.
128+
129+
Otros casos (uno o dos ausentes, orden incorrecto, sección vacía) no se corrigen automáticamente — la posición correcta depende de la intención del test, y el mensaje de error te dice exactamente «qué» añadir y «dónde».

docs/es/guide/phpcs.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,3 +89,9 @@ public function testAlsoBad(): void
8989
$this->assertSame($y, $x);
9090
}
9191
```
92+
93+
## Auto-fix
94+
95+
Cuando los tres comentarios de sección están **todos ausentes**, `vendor/bin/phpcbf` (el auto-fixer incluido con PHP_CodeSniffer) inserta una plantilla `// arrange` / `// act` / `// assert` al inicio del método de test. Luego solo tienes que mover cada comentario sobre el código que le corresponde.
96+
97+
Otros casos (uno o dos ausentes, orden incorrecto, sección vacía) no se corrigen automáticamente — la posición correcta depende de la intención del test, y el mensaje de error te dice exactamente «qué» añadir y «dónde».

docs/es/guide/rubocop.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,9 @@ it 'also bad' do
9191
expect(x).to eq(y)
9292
end
9393
```
94+
95+
## Auto-corrección
96+
97+
Cuando los tres comentarios de sección están **todos ausentes**, `rubocop -a` (o `--autocorrect`) inserta una plantilla `# arrange` / `# act` / `# assert` al inicio del bloque. Luego solo tienes que mover cada comentario sobre el código que le corresponde.
98+
99+
Otros casos (uno o dos ausentes, orden incorrecto, sección vacía) no se auto-corrigen — la posición correcta depende de la intención del test, y el mensaje de la offense te dice exactamente «qué» añadir y «dónde».

docs/fr/guide/eslint.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,3 +121,9 @@ it('also bad', () => {
121121
expect(x).toBe(y)
122122
})
123123
```
124+
125+
## Auto-fix
126+
127+
Quand les trois commentaires de section manquent **tous**, `eslint --fix` insère un modèle `// arrange` / `// act` / `// assert` en haut du bloc de test. Il ne reste plus qu'à déplacer chaque commentaire au-dessus du code qui lui correspond.
128+
129+
Les autres cas (un ou deux manquants, ordre incorrect, section vide) ne sont pas corrigés automatiquement — l'emplacement correct dépend de l'intention du test, et le message d'erreur indique précisément « quoi » ajouter et « où ».

docs/fr/guide/phpcs.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,3 +89,9 @@ public function testAlsoBad(): void
8989
$this->assertSame($y, $x);
9090
}
9191
```
92+
93+
## Auto-fix
94+
95+
Quand les trois commentaires de section manquent **tous**, `vendor/bin/phpcbf` (l'auto-fixer livré avec PHP_CodeSniffer) insère un modèle `// arrange` / `// act` / `// assert` en haut de la méthode de test. Il ne reste plus qu'à déplacer chaque commentaire au-dessus du code qui lui correspond.
96+
97+
Les autres cas (un ou deux manquants, ordre incorrect, section vide) ne sont pas corrigés automatiquement — l'emplacement correct dépend de l'intention du test, et le message d'erreur indique précisément « quoi » ajouter et « où ».

docs/fr/guide/rubocop.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,9 @@ it 'also bad' do
9191
expect(x).to eq(y)
9292
end
9393
```
94+
95+
## Auto-correction
96+
97+
Quand les trois commentaires de section manquent **tous**, `rubocop -a` (ou `--autocorrect`) insère un modèle `# arrange` / `# act` / `# assert` en haut du bloc. Il ne reste plus qu'à déplacer chaque commentaire au-dessus du code qui lui correspond.
98+
99+
Les autres cas (un ou deux manquants, ordre incorrect, section vide) ne sont pas auto-corrigés — l'emplacement correct dépend de l'intention du test, et le message d'offense indique précisément « quoi » ajouter et « où ».

docs/guide/eslint.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,3 +121,9 @@ it('also bad', () => {
121121
expect(x).toBe(y)
122122
})
123123
```
124+
125+
## Auto-fix
126+
127+
When **all three** section comments are missing, `eslint --fix` inserts a `// arrange` / `// act` / `// assert` template at the top of the test block. You then move each comment above the code that belongs to it.
128+
129+
Other cases (one or two missing, wrong order, empty section) are not auto-fixed because the correct insertion point depends on the test's intent — the error message tells you exactly what to add and where.

0 commit comments

Comments
 (0)