Adds a data definition example
Removes "motivation" section to just mention distinguishing features in the intro

@@ -3,0 +22,4 @@
+
+#### Basic entity
+
+TODO

@@ -0,0 +9,4 @@
+ * When implementing this interface the constructor must have a parameter called `id` of the type {@see Entity\Id}.
+ * Further configuration of the ID requires adding the {@see Schema\IdOptions} attribute.
+ *
+ * Fields are declared as parameters to the constructor of the entity.

@@ -0,0 +12,4 @@
+ * Fields are declared as parameters to the constructor of the entity.
+ * These parameters are later used to reconstruct an entity from a database record.
+ * Parameters can be excluded using the {@see Schema\Exclude} attribute.
+ * The {@see Schema\FieldName} attribute specifies the field name if the parameter name should not be used.

@@ -0,0 +11,4 @@
+/**
+ * Definition of an {@see Entity}'s structure and its relationships to other entities.
+ *
+ * Use the {@see Schema\Exclude} attribute to exclude a field.

@@ -0,0 +36,4 @@
+	/**
+	 * Creates a schema from the constructor parameters of a given class.
+	 *
+	 * If the given class implements {@see Entity\Identifiable} it is required to declared an `$id`

@@ -0,0 +26,4 @@
+	/**
+	 * The entity's regular fields.
+	 *
+	 * Does not contain the `id` field if the entity implements {@see Entity\Identifiable}.

@@ -0,0 +60,4 @@
+				throw Schema\DefinitionException::forMissingIdField();
+			}
+
+			$object->__construct($idOptions ?? new Schema\IdOptions(Schema\IdGenerator::None), $fields);

@@ -0,0 +57,4 @@
+	/** @return array{ type: Type, nullable: bool } */
+	private static function extractTypeInfo(ReflectionParameter $parameter): array {
+		$type = $parameter->getType();
+		if ($type === null) {

@@ -0,0 +5,4 @@
+use Attribute;
+
+/**
+ * Allows specifying a different name for a field than the one implied by parameter or property.

@@ -0,0 +15,4 @@
+final class IdOptionsTest extends TestCase {
+
+	public function test___construct_shouldNotThrow(): void {
+		$sut = new IdOptions(IdGenerator::UniqueIdentifier);

@@ -0,0 +39,4 @@
+		$this->assertFalse(isset($resultFields['id']));
+	}
+
+	public function test_fromConstructorParameters_shouldIgnoreExcludeAttributeAndSetDefaultGenerator_whenExcludeAttributeIsApplied(): void {