diff --git a/README.md b/README.md
index cdfd50dd..d5262bbf 100644
--- a/README.md
+++ b/README.md
@@ -3,61 +3,140 @@
Project containing [Mustache-templates](https://mustache.github.io/) used by [openapi-generator-maven-plugin](https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md) to generate [Java Records](https://docs.oracle.com/en/java/javase/17/language/records.html) from [OpenAPI Specifications](https://swagger.io/specification/).
This project contains the **mustache templates**.
-> [!NOTE]
-> There is also an example OpenAPI Specification which will generate example Java classes (Records & Enums).
-> **This is for testing purposes only**, and will **not** be included when importing the project. The templates
-> support a variety of different properties and configurations. Just for reference, generated classes can be found
-> under [/target/generated-sources/...](./target/generated-sources/openapi/src/src/gen/java/main/io/github/chrimle/example).
-# Example
+# Getting Started
+The mustache templates can be acquired through multiple ways.
+- [Maven Central Repository](https://central.sonatype.com/artifact/io.github.chrimle/openapi-to-java-records-mustache-templates)
+- [GitHub Packages](https://github.com/Chrimle/openapi-to-java-records-mustache-templates/packages/)
+- Downloading them manually from [GitHub](https://github.com/Chrimle/openapi-to-java-records-mustache-templates/tree/main/src/main/resources/templates)
-The following is an example of a Java record generated from an OpenAPI Specification, with default `openapi-generator-maven-plugin`-configurations.
+## Import Dependency
+```xml
+
+ io.github.chrimle
+ openapi-to-java-records-mustache-templates
+ 1.8.0
+
+```
-## Maven
-> [!IMPORTANT]
-> Some `openapi-generator-maven-plugin`-configuration options have not yet been verified. By using them, they may either be ignored or may even cause issues.
->
-> Due to the sheer number of ``-options, this section has been moved to the Wiki-page: [Supported 'openapi‐generator‐maven‐plugin' Configuration options
-](https://github.com/Chrimle/openapi-to-java-records-mustache-templates/wiki/Supported-%27openapi‐generator‐maven‐plugin%27-Configuration-options)
+## Use the `.mustache` templates when generating
+Place the file(s) in desired directory. Then, in the Maven build configuration, set the property `` to the directory path. Example:
+```xml
+
+
+
+ org.openapitools
+ openapi-generator-maven-plugin
+
+
+
+ generate
+
+
+
+
+
+
+
+
+
+
+
+```
+## Additional Configurations
+The generated classes are customizable by using ``-properties.
+
+In this example, each generated class will be named with the suffix "DTO", and fields of generated records will be annotated with [Jakarta Bean Validation annotations](https://jakarta.ee/specifications/bean-validation/3.0/jakarta-bean-validation-spec-3.0.html#builtinconstraints).
+```xml
+
+ DTO
+
+
+ true
+
+
+
+```
+
+> [!TIP]
+> See [Supported 'openapi‐generator‐maven‐plugin' Configuration options](https://github.com/Chrimle/openapi-to-java-records-mustache-templates/wiki/Supported-%27openapi‐generator‐maven‐plugin%27-Configuration-options)
## OpenAPI Specification
```yaml
components:
schemas:
- Example:
- description: This is an example
+ Person:
+ description: Personal information
deprecated: true
type: object
+ required:
+ - fullName
+ - age
+ - gender
+ - height
+ - ssn
+ - aliases
+ - trackingCode
properties:
- text:
- description: Example text property
+ fullName:
+ description: Full name
type: string
- nullableText:
- description: Example nullable text property with default value
+ minLength: 2
+ maxLength: 50
+ age:
+ description: Age (years)
+ type: integer
+ minimum: 0
+ maximum: 100
+ gender:
+ $ref: '#/components/schemas/Gender'
+ height:
+ description: Height (m)
+ type: number
+ pattern: float
+ minimum: 0
+ ssn:
+ description: Social Security Number
type: string
- default: someDefaultValue
- nullable: true
- collection:
- description: Example list property
+ pattern: '^\d{3}-\d{2}-\d{4}$'
+ aliases:
+ description: Known Aliases
type: array
+ uniqueItems: true
+ minItems: 1
+ maxItems: 3
items:
- type: integer
- composite:
- $ref: '#/components/schemas/Composite'
- Composite:
- description: This is a composite object
- type: object
- properties:
- text:
- description: Example text property
+ type: string
+ telephoneNumber:
+ description: Telephone Number
type: string
+ nullable: true
+ trackingCode:
+ description: Tracking code for Web analytics
+ type: string
+ default: "utm_source=default"
+ Gender:
+ description: Gender
+ type: string
+ enum:
+ - Male
+ - Female
+```
+> [!TIP]
+> See [Supported OpenAPI Specification properties](https://github.com/Chrimle/openapi-to-java-records-mustache-templates/wiki/Supported-OpenAPI-Specification-properties)
+
+## Generate models
+Compile the project, for example via:
+```console
+mvn compile
```
-> [!IMPORTANT]
-> See the complete list of [Supported OpenAPI Specification properties](https://github.com/Chrimle/openapi-to-java-records-mustache-templates/wiki/Supported-OpenAPI-Specification-properties)
-> on the wiki!
-## Java Record
+> [!TIP]
+> Further information about how to generate models can be found on [openapi-generator-maven-plugin](https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md).
+
+## Generated Java Record
+Unless the configuration property `