Incoherence in the intro paragraph between Doctrine and Propel

[arnaugm]

In the introductory paragraphs of Doctrine and Propel we find the following sentences:

Fortunately, Symfony comes integrated with Doctrine.

Symfony does not come integrated with any ORMs but the Propel integration is easy.

It doesn't sound very coherent does it?

[xabbuh]

Well, both are true in some way. Actually, the full-stack framework doesn't ship with any ORM at all. But, when you are using the Symfony Standard Edition (and most people will start with it), you'll get Doctrine support "for free".

I agree with you that this doesn't sound very consistent though. Maybe we could reword the Doctrine part to something like

The Symfony full-stack framework doesn't integrate any ORM by default. Fortunately, the Symfony Standard Edition which you are using already comes integrated with Doctrine.

What do you think?

[arnaugm]

Yes I agree that both are true in some way, but if you read them toghether it's a bit confusing.
Your new proposal sounds much more clear. Should I create a pull request for it?

[xabbuh]

@arnaugm Go for it. We can then see what the others think about this and maybe adapt their thoughts if they have better wordings in mind.

[arnaugm]

Thanks both, I'm happy to have my first contribution to the Symfony documentation! And I'm sure it won't be the last one.

[weaverryan]

Congrats! Definitely don't let it be the last ;)