Merge branch 'main' into oleg-nenashev-patch-1

Author: tomakehurst

README.md

@@ -25,7 +25,7 @@ For Gradle users:
 
 ```groovy
 dependencies {
-    implementation 'org.wiremock:wiremock-faker-extension:0.1.0'
+    implementation 'org.wiremock.extensions:wiremock-faker-extension-standalone:0.1.1'
 }
 ```
 
@@ -39,8 +39,17 @@ new WireMockServer(wireMockConfig().extensions(RandomExtension.class));
 
 ### Step 3: Use it in your stubs!
 
-```yaml
+{% raw %}
+```handlebars
 {{ random 'Name.first_name' }}
 ```
+{% endraw %}
 
 This will generate random first names in the `en-US` locale for every request.
+
+
+### Technical notes
+This library brings `net.datafaker:datafaker` as transitive dependency, which may result in conflicts at building time. 
+If that's the case, the `net.datafaker:datafaker` dependency needs to be excluded. 
+
+For a full reference of the available keys, see the [Reference Documentation](./docs/reference.md).