Skip to content

Commit 0da1990

Browse files
Discourage i18n.folders config (#2559)
Discourage users from changing the `cds.i18n.folders` configuration, which lead to frequent confusion among users and often did not match their expectations/ lead to bugs. --------- Co-authored-by: René Jeglinsky <rene.jeglinsky@sap.com>
1 parent 452e976 commit 0da1990

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

node.js/cds-i18n.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -655,9 +655,9 @@ cds.env.i18n = {
655655
| `cds.i18n.folders` | An array of (relative) folder names that will be appended to the source directories in a cross-product fashion of the default `cds.model` when fetching for existing i18n [`folders`](#folders). <br />*Default:* `["_i18n","i18n"]` |
656656
| `cds.i18n.default_language` | The locale used for [default translations](#defaults). <br />*Default:* `"en"` |
657657

658-
::: danger
658+
::: danger Do not switch defaults without proper evaluation
659659

660-
Changing these configurations does not only affect your usage of your i18n bundles, but also all bundles provided by reuse packages you might use, including the ones provided by the CAP framework itself, such as the labels for the `@sap/cds/common` types, or the default messages used by the Node.js runtime.
660+
Changing these configurations does not only affect your usage of your i18n bundles, but also all bundles provided by reuse packages you might use, including the ones provided by the CAP framework itself, such as the labels for the `@sap/cds/common` types, or the default messages used by the Node.js runtime. It is therefore highly recommended to leave this setting as is and adhere to the default name `_i18n` for your i18n directory.
661661

662662
:::
663663

0 commit comments

Comments
 (0)