Skip to content

Commit 7b2b8bc

Browse files
docs: update translation-debugger skill for v2.1 persist methods
Update diagnostics.md Check 4.3 to recommend translateAndPersist() and getOrTranslate() as v2.1 alternatives to manual persist(). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 237072d commit 7b2b8bc

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

.agents/skills/translation-debugger/references/diagnostics.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -267,6 +267,15 @@ doctrine:
267267

268268
**How to check:**
269269
```php
270+
// v2.1 recommended: auto-persist convenience methods
271+
$translated = $entityTranslator->translateAndPersist($source, 'fr');
272+
$entityManager->flush();
273+
274+
// v2.1 find-or-create: returns existing or creates + persists new
275+
$translated = $entityTranslator->getOrTranslate($source, 'fr');
276+
$entityManager->flush();
277+
278+
// Manual (v2.0 pattern):
270279
$translated = $entityTranslator->translate($source, 'fr');
271280
$entityManager->persist($translated); // Required!
272281
$entityManager->flush();
@@ -276,7 +285,7 @@ $entityManager->flush();
276285
- **Severity:** INFO
277286
- **Error:** No error during translation
278287
- **Symptom:** Translation not in database
279-
- **Reminder:** Translator creates NEW entity, must be persisted
288+
- **Reminder:** `translate()` creates a NEW entity that must be persisted. Use `translateAndPersist()` or `getOrTranslate()` (v2.1) to auto-persist.
280289
- **llms.md:** See "Translations Not Persisted" troubleshooting entry
281290

282291
### Check 4.4: Collection Translation Duplicates

0 commit comments

Comments
 (0)