Improve documentation and DevUI

Author: mcruzdev

docs/modules/ROOT/pages/mock.adoc renamed to docs/modules/ROOT/pages/moqu.adoc

@@ -87,52 +87,44 @@ Example:
 
 [source,yaml]
 ----
-  "/frameworks/{id}":
+openapi: 3.0.3
+info:
+  title: "Users API"
+  version: 1.0.0-alpha
+servers:
+  - url: http://localhost:8888
+paths:
+  /users/{id}:
     get:
+      description: Get user by ID
       parameters:
         - name: id
           in: path
+          required: true
+          schema:
+            type: number
           examples:
-            quarkus: <1>
+            john: <1>
               value: 1 <2>
       responses:
-        200:
+        "200":
+          description: Ok
           content:
             "application/json":
               examples:
-                quarkus: <3>
-                  $ref: "#/components/schemas/Framework"
-          description: Ok
-components:
-  schemas:
-    Framework:
-      type: object
-      properties:
-        name:
-          type: string
-          example: "Quarkus"
-        versions:
-          type: array
-          example: ["999-SNAPSHOT", "3.15.1"]
-        supportsJava:
-          type: boolean
-          example: true
-        contributors:
-          type: integer
-          example: 1000
-        rules:
-          type: object
-          example:
-            hello: world
+                john: <3>
+                  value:
+                    '{"id": 1, "name": "John Doe"}'
 ----
 
-<1> Defines an example named `quarkus`.
-<2> Specifies that the request `/frameworks/1` will match the `quarkus` example.
-<3> Maps the response for the `quarkus` example.
+<1> Defines an example named `john` for request
+<2> Maps the request for path `/users/1` should use the response named as `john`
+<2> Defines an example named `john` for response
 
-In other words, if the user accesses `/frameworks/1` (using the `quarkus` example), the response will be the one mapped for the `quarkus` example, which in this case references the Framework schema defined in the OpenAPI specification.
 
-The Wiremock created using the OpenAPI specification above looks like this one:
+In other words, if the user accesses `/users/1`, the response will be the one mapped for the `john` example in response.
+
+The Wiremock definition using the OpenAPI specification above, looks something like this:
 
 [source,json]
 ----
@@ -141,14 +133,71 @@ The Wiremock created using the OpenAPI specification above looks like this one:
         {
           "request": {
           "method": "GET",
-          "url": "/frameworks/1"
+          "url": "/users/1"
         },
           "response": {
           "status": 200,
-          "body": "{\"supportsJava\":true,\"versions\":[\"999-SNAPSHOT\",\"3.15.1\"],\"name\":\"Quarkus\",\"rules\":{\"hello\":\"world\"},\"contributors\":1000}",
+          "body": "{\"name\":\"John\",\"age\": 80}",
           "headers": {}
         }
       }
   ]
 }
+----
+
+=== Response as Schema
+
+You can use the `$ref` to reference a schema for mapping a response:
+
+[source,yaml]
+----
+paths:
+  "/users/{id}":
+    get:
+      parameters:
+        - name: id
+          in: path
+          examples:
+            alice:
+              value: 1
+      responses:
+        200:
+          content:
+            "application/json":
+              examples:
+                alice:
+                  $ref: "#/components/schemas/User"
+          description: Ok
+components:
+  schemas:
+    User:
+      type: object
+      properties:
+        name:
+          type: string
+          example: "Alice"
+        age:
+          type: number
+          example: 80
+----
+
+The Wiremock definition using the OpenAPI specification above, looks something like this:
+
+[source,json]
+----
+{
+    "mappings": [
+        {
+            "request": {
+                "method": "GET",
+                "url": "/users/1"
+            },
+            "response": {
+                "status": 200,
+                "body": "{\"name\":\"Alice\",\"age\":80}",
+                "headers": {}
+            }
+        }
+    ]
+}
 ----

moqu/deployment/src/main/java/io/quarkiverse/openapi/generator/devui/Mock.java

@@ -2,25 +2,24 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <parent>
-        <artifactId>quarkus-openapi-generator-moqu-parent</artifactId>
+        <artifactId>quarkus-openapi-generator-moqu-wiremock-parent</artifactId>
         <groupId>io.quarkiverse.openapi.generator</groupId>
         <version>3.0.0-SNAPSHOT</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
-    <artifactId>quarkus-openapi-generator-moqu-deployment</artifactId>
-    <name>Quarkus - Openapi Generator - Moqu - Deployment</name>
+    <artifactId>quarkus-openapi-generator-moqu-wiremock-deployment</artifactId>
+    <name>Quarkus - Openapi Generator - Moqu - Wiremock - Deployment</name>
 
     <dependencies>
-        <!-- Quarkus -->
         <dependency>
             <groupId>io.quarkus</groupId>
             <artifactId>quarkus-core-deployment</artifactId>
         </dependency>
         <dependency>
             <groupId>io.quarkiverse.openapi.generator</groupId>
-            <artifactId>quarkus-openapi-generator-moqu</artifactId>
+            <artifactId>quarkus-openapi-generator-moqu-wiremock</artifactId>
             <version>${project.version}</version>
         </dependency>
         <dependency>