diff --git a/translation.rst b/translation.rst index 9a9effd3527..db50e05cb07 100644 --- a/translation.rst +++ b/translation.rst @@ -655,9 +655,12 @@ priority message files. The filename of the translation files is also important: each message file must be named according to the following path: ``domain.locale.loader``: -* **domain**: An optional way to organize messages into groups. Unless +* **domain**: Domains are a way to organize messages into groups. Unless parts of the application are explicitly separated from each other, it is - recommended to only use default ``messages`` domain; + recommended to only use default ``messages`` domain. + + If no domains are explicitly defined while using the translator, Symfony + will default to the ``messages`` domain (e.g. ``messages.en.yaml``) * **locale**: The locale that the translations are for (e.g. ``en_GB``, ``en``, etc);