Skip to content

Commit c524f17

Browse files
committed
[Doctrine] Reword the intro of the main article
1 parent 4bc05f0 commit c524f17

File tree

1 file changed

+12
-8
lines changed

1 file changed

+12
-8
lines changed

doctrine.rst

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,18 @@ Databases and the Doctrine ORM
99

1010
Do you prefer video tutorials? Check out the `Doctrine screencast series`_.
1111

12-
Symfony doesn't provide a component to work with the database, but it *does* provide
13-
tight integration with a third-party library called `Doctrine`_.
12+
Symfony provides all the tools you need to use databases in your applications
13+
thanks to `Doctrine`_, the best set of PHP libraries to work with databases.
14+
These tools support relational databases like MySQL and PostgreSQL and also
15+
NoSQL databases like MongoDB.
1416

15-
.. note::
16-
17-
This article is all about using the Doctrine ORM. If you prefer to use raw
18-
database queries, see the ":doc:`/doctrine/dbal`" article instead.
17+
Databases are a broad topic, so the documentation is divided in three articles:
1918

20-
You can also persist data to `MongoDB`_ using Doctrine ODM library. See the
21-
"`DoctrineMongoDBBundle`_" documentation.
19+
* This article explains the recommended way to work with **relational databases**
20+
in Symfony applications;
21+
* Read :doc:`this other article </doctrine/dbal>` if you need **low-level access**
22+
to perform raw SQL queries to relational databases (similar to PHP's `PDO`_);
23+
* Read `DoctrineMongoDBBundle docs`_ if you are working with MongoDB databases.
2224

2325
Installing Doctrine
2426
-------------------
@@ -878,6 +880,7 @@ Learn more
878880
.. _`Query Builder`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/query-builder.html
879881
.. _`Doctrine Query Language`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/dql-doctrine-query-language.html
880882
.. _`Reserved SQL keywords documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
883+
.. _`DoctrineMongoDBBundle docs`: https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
881884
.. _`DoctrineMongoDBBundle`: https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
882885
.. _`DoctrineFixturesBundle`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
883886
.. _`Transactions and Concurrency`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/transactions-and-concurrency.html
@@ -888,3 +891,4 @@ Learn more
888891
.. _`limit of 767 bytes for the index key prefix`: https://dev.mysql.com/doc/refman/5.6/en/innodb-restrictions.html
889892
.. _`Doctrine screencast series`: https://symfonycasts.com/screencast/symfony-doctrine
890893
.. _`API Platform`: https://api-platform.com/docs/core/validation/
894+
.. _`PDO`: https://php.net/pdo

0 commit comments

Comments
 (0)