docs: add YAML notation for single property deprecation (#1382)

Author: jzabrodin

core/default-order.md

@@ -31,7 +31,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         order:
@@ -74,7 +74,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         order: ['foo', 'bar']
@@ -110,7 +110,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         order: ['author.username']
@@ -144,7 +144,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     get: ~
     get_desc_custom:

core/deprecations.md

@@ -73,6 +73,8 @@ class Parchment
 
 It's also possible to deprecate a single property:
 
+[codeSelector]
+
 ```php
 <?php
 // api/src/Entity/Review.php
@@ -98,6 +100,20 @@ class Review
 }
 ```
 
+```yaml
+# api/config/api_platform/resources/Review.yaml
+resources:
+    # ...
+    App\Entity\Review:
+        properties:
+            # ...
+            letter:
+                attributes:
+                    deprecation_reason: 'Use the rating property instead'
+```
+
+[/codeSelector]
+
 * With JSON-lD / Hydra, [an `owl:deprecated` annotation property](https://www.w3.org/TR/owl2-syntax/#Annotation_Properties) will be added to the appropriate data structure
 * With Swagger / OpenAPI, [a `deprecated` property](https://swagger.io/docs/specification/2-0/paths-and-operations/) will be added
 * With GraphQL, the [`isDeprecated` and `deprecationReason` properties](https://facebook.github.io/graphql/June2018/#sec-Deprecation) will be added to the schema

core/identifiers.md

@@ -35,7 +35,7 @@ final class Person
 ```
 
 ```yaml
-# config/api/resources/Person.yaml
+# api/config/api_platform/resources/Person.yaml
 App\Entity\Person:
     properties:
         code:

core/security.md

@@ -98,7 +98,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     properties:
         adminOnlyProperty:
@@ -213,7 +213,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         security: 'is_granted("ROLE_USER")'

core/serialization.md

@@ -199,7 +199,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         normalization_context:
@@ -210,7 +210,7 @@ App\Entity\Book:
             normalization_context:
                 groups: ['put']
 
-# config/serializer/Book.yaml
+# api/config/serializer/Book.yaml
 App\Entity\Book:
     attributes:
         name:
@@ -305,21 +305,21 @@ class Person
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         normalization_context:
             groups: ['book']
 
-# config/serializer/Book.yaml
+# api/config/serializer/Book.yaml
 App\Entity\Book:
     attributes:
         name:
             groups: ['book']
         author:
             groups: ['book']
 
-# config/serializer/Person.yaml
+# api/config/serializer/Person.yaml
 App\Entity\Person:
     attributes:
         name:
@@ -373,7 +373,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         denormalization_context:
@@ -432,15 +432,15 @@ class Person
 ```
 
 ```yaml
-# config/api/resources/Person.yaml
+# api/config/api_platform/resources/Person.yaml
 App\Entity\Person:
     attributes:
         normalization_context:
             groups: ['person']
         denormalization_context:
             groups: ['person']
 
-# config/serializer/Person.yaml
+# api/config/serializer/Person.yaml
 App\Entity\Person:
     attributes:
         name:
@@ -495,7 +495,7 @@ class Person
 ```
 
 ```yaml
-# config/api/resources/Person.yaml
+# api/config/api_platform/resources/Person.yaml
 App\Entity\Person:
     attributes:
         normalization_context:
@@ -507,7 +507,7 @@ App\Entity\Person:
             readableLink: false
             writableLink: false
 
-# config/serializer/Person.yaml
+# api/config/serializer/Person.yaml
 App\Entity\Person:
     attributes:
         name:
@@ -692,14 +692,14 @@ class Greeting
 ```
 
 ```yaml
-# config/api/resources/Greeting.yaml
+# api/config/api_platform/resources/Greeting.yaml
 App\Entity\Greeting:
     collectionOperations:
         get:
             normalization_context:
                 groups: 'greeting:collection:get'
 
-# config/serializer/Greeting.yaml
+# api/config/serializer/Greeting.yaml
 App\Entity\Greeting:
     attributes:
         id:
@@ -760,15 +760,15 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book: 
     attributes:
         normalization_context:
             groups: ['book:output']
         denormalization_context:
             groups: ['book:input']
 
-# config/serializer/Book.yaml
+# api/config/serializer/Book.yaml
 App\Entity\Book:
     attributes:
         active:
@@ -1112,7 +1112,7 @@ class Book
 ```
 
 ```yaml
-# config/api/resources/Book.yaml
+# api/config/api_platform/resources/Book.yaml
 App\Entity\Book:
     attributes:
         normalization_context: