fix: Change translation domain name for bundle translation and add an example

jbonnier · jbonnier · commit 20929b4a573a · 2025-03-22T15:47:08.000-04:00
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
@@ -397,10 +397,14 @@ Translation Files
 -----------------
 
 If a bundle provides message translations, they must be defined in the XLIFF
-format; the domain should be named after the bundle name (``acme_blog``).
+format; the domain should be named after the bundle name (``AcmeBlog``).
 
 A bundle must not override existing messages from another bundle.
 
+The translation domain must match the translation file names. For example,
+if the translation domain is ``AcmeBlog``, the English translation file name
+should be ``AcmeBlog.en.xlf``.
+
 Configuration
 -------------
 
