From 8d1c6345c91f31257c5c4bac18624f04f432e9e9 Mon Sep 17 00:00:00 2001
From: Ivan Yivoff <yivi@users.noreply.github.com>
Date: Wed, 20 Jan 2021 11:07:06 +0100
Subject: [PATCH 1/3] show XML syntax for @ApiProperty(identifier=true)

Sadly it took me a bit to find it, since I had misread the XSD. Could be useful to show the alternative configuration syntax for others like me.
---
 core/identifiers.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/core/identifiers.md b/core/identifiers.md
index 0e2e5fc4aed..67d91ddbdf3 100644
--- a/core/identifiers.md
+++ b/core/identifiers.md
@@ -9,6 +9,7 @@ To help with your development experience, we introduced an identifier normalizat
 
 Let's say you have the following class, which is identified by a `UUID` type. In this example, `UUID` is not a simple string but an object with many attributes.
 
+[codeSelector]
 ```php
 <?php
 namespace App\Entity;
@@ -32,6 +33,19 @@ final class Person
 }
 ```
 
+```xml
+<resources xmlns="https://api-platform.com/schema/metadata">
+    <resource class="App\EntityPerson">
+
+        <property name="code" identifier="true"/>
+
+    </resource>
+</resources>
+```
+[/codeSelector]
+
+
+
 Once registered as an `ApiResource`, having an existing person, it will be accessible through the following URL: `/people/110e8400-e29b-11d4-a716-446655440000`.
 Note that the property identifying our resource is named `code`.
 

From 8390e3c969f027a3571279f8484552449d20c61e Mon Sep 17 00:00:00 2001
From: Alan Poulain <contact@alanpoulain.eu>
Date: Wed, 20 Jan 2021 11:12:01 +0100
Subject: [PATCH 2/3] Remove empty lines

---
 core/identifiers.md | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/core/identifiers.md b/core/identifiers.md
index 67d91ddbdf3..56fd07a896c 100644
--- a/core/identifiers.md
+++ b/core/identifiers.md
@@ -43,9 +43,6 @@ final class Person
 </resources>
 ```
 [/codeSelector]
-
-
-
 Once registered as an `ApiResource`, having an existing person, it will be accessible through the following URL: `/people/110e8400-e29b-11d4-a716-446655440000`.
 Note that the property identifying our resource is named `code`.
 

From fcbb91190ab820611d76481e3d34a1fe0f3237ad Mon Sep 17 00:00:00 2001
From: Alan Poulain <contact@alanpoulain.eu>
Date: Wed, 20 Jan 2021 11:13:20 +0100
Subject: [PATCH 3/3] Remove empty lines

---
 core/identifiers.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/core/identifiers.md b/core/identifiers.md
index 56fd07a896c..7823100250c 100644
--- a/core/identifiers.md
+++ b/core/identifiers.md
@@ -36,13 +36,12 @@ final class Person
 ```xml
 <resources xmlns="https://api-platform.com/schema/metadata">
     <resource class="App\EntityPerson">
-
         <property name="code" identifier="true"/>
-
     </resource>
 </resources>
 ```
 [/codeSelector]
+
 Once registered as an `ApiResource`, having an existing person, it will be accessible through the following URL: `/people/110e8400-e29b-11d4-a716-446655440000`.
 Note that the property identifying our resource is named `code`.