Added doc to show how to use the force flag when creating a person

docs/out/PersonAPI.md

@@ -133,6 +133,28 @@
 
 ```
 
+Sometimes it will happen that you have to add a person with the same name
+as an existing one. ChurchTools will respond with an error to prevent you from
+adding duplicates accidently.
+
+Therefore you can add the `force` parameter and set it to `true`.
+
+```php
+        use CTApi\Models\Person;
+        use CTApi\Requests\PersonRequest;
+
+        $newPerson = new Person();
+        $newPerson->setFirstName("John")
+            ->setLastName("Doe")
+            ->setBirthday("1970-01-01");
+        //add further attributes
+
+        PersonRequest::create($newPerson, force: true);
+
+```
+
+This will make ChurchTools to insert the record, even if there is a second John Doe.
+
 ## Update a person's data
 
 Use the setters of the person model to modify its data and utilize the

docs/src/ressources/PersonAPI.md

@@ -14,6 +14,16 @@
 
 {{ \Tests\Unit\Docs\PersonRequestTest.testCreatePerson }}
 
+Sometimes it will happen that you have to add a person with the same name
+as an existing one. ChurchTools will respond with an error to prevent you from
+adding duplicates accidently.
+
+Therefore you can add the `force` parameter and set it to `true`.
+
+{{ \Tests\Unit\Docs\PersonRequestTest.testCreatePersonWithEqualName }}
+
+This will make ChurchTools to insert the record, even if there is a second John Doe.
+
 ## Update a person's data
 
 Use the setters of the person model to modify its data and utilize the

tests/unit/Docs/PersonRequestTest.php

@@ -56,6 +56,20 @@ public function testCreatePerson()
         PersonRequest::create($newPerson);
     }
 
+    /**
+     * @doesNotPerformAssertions
+     */
+    public function testCreatePersonWithEqualName()
+    {
+        $newPerson = new Person();
+        $newPerson->setFirstName("John")
+            ->setLastName("Doe")
+            ->setBirthday("1970-01-01");
+        //add further attributes
+
+        PersonRequest::create($newPerson, force: true);
+    }
+
     /**
      * @doesNotPerformAssertions
      */