Deprecate ReST API

[jordisala1991]

Subject

I am targeting this branch, because this is BC.

Changelog

### Deprecated
- Deprecated ReST API with FOSRest, Nelmio Api Docs and JMS Serializer.

[jordisala1991]

Same was applied for other bundles. Once merged, merged to 5.x and removed deprecated messages, we can deprecate DatagridBundle safely.

[wbloszyk]

Can you add upgrade note? https://github.com/sonata-project/SonataPageBundle/pull/1365/files#diff-c698cbb1f2afce655c27e32ebfc8d9f37af04b8164a1d8d609da71d2858c6697

And also be consider and add NEXT_MAJOR to whole @deprecated.

[jordisala1991]

Can you add upgrade note? https://github.com/sonata-project/SonataPageBundle/pull/1365/files#diff-c698cbb1f2afce655c27e32ebfc8d9f37af04b8164a1d8d609da71d2858c6697

And also be consider and add NEXT_MAJOR to whole @deprecated.

Done, Added upgrade note and added more next major comments.

[VincentLanglet]

We need to add NEXT_MAJOR to removeable PageableInterface in
https://github.com/sonata-project/SonataUserBundle/blob/8885f677e0dfde1e02d88f3ec0b48c2dd8dfa8c5/src/Model/UserManagerInterface.php
https://github.com/sonata-project/SonataUserBundle/blob/8885f677e0dfde1e02d88f3ec0b48c2dd8dfa8c5/src/Model/GroupManagerInterface.php

And need to deprecate and add a NEXT_MAJOR for getPager method

SonataUserBundle/src/Entity/UserManager.php

Line 119 in 8885f67

public function getPager(array $criteria, int $page, int $limit = 10, array $sort = []): PagerInterface

SonataUserBundle/src/Entity/GroupManager.php

Line 37 in 8885f67

public function getPager(array $criteria, int $page, int $limit = 10, array $sort = []): PagerInterface

SonataUserBundle/src/Document/UserManager.php

Line 36 in 8885f67

public function getPager(array $criteria, int $page, int $limit = 10, array $sort = []): PagerInterface

SonataUserBundle/src/Document/GroupManager.php

Line 36 in 8885f67

public function getPager(array $criteria, int $page, int $limit = 10, array $sort = []): PagerInterface

This allow to remove the datagridBundle dependency

[VincentLanglet]

This PR will allow to close sonata-project/dev-kit#1465 :)

[jordisala1991]

I already added all deprecations, can you point where it is missing? Both entity folder and model folder are already done.

[VincentLanglet]

I already added all deprecations, can you point where it is missing? Both entity folder and model folder are already done.

Sorry, I need glasses.

[jordisala1991]

I will try the merge and the code removal later