Skip to content

Commit 1547d51

Browse files
committed
Used suggested text to make it more clear to people who are new to the project why this is best practice
1 parent e8fbcf4 commit 1547d51

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

docs/en/tutorials/getting-started.rst

+7-4
Original file line numberDiff line numberDiff line change
@@ -114,10 +114,13 @@ Add the following directories:
114114
The YAML driver is deprecated and will be removed in version 3.0.
115115
It is strongly recommended to switch to one of the other mappings.
116116
.. note::
117-
When using the entity data mapping it is best practice to explicity
118-
specify the version of ``doctrine/dbal`` in your ``composer.json``.
119-
This helps ensure that your entity data mappings remain supported
120-
through package upgrades.
117+
It is strongly recommended that you require doctrine/dbal in your
118+
composer.json as well, because using the ORM means mapping objects
119+
and their fields to database tables and their columns, and that
120+
requires mentioning so-called types that are defined in doctrine/dbal
121+
in your application. Having an explicit requirement means you control
122+
when the upgrade to the next major version happens, so that you can
123+
do the necessary changes in your application beforehand.
121124

122125
Obtaining the EntityManager
123126
---------------------------

0 commit comments

Comments
 (0)