improve readme with information about conversions

Author: JaredCE

README.md

@@ -8,12 +8,156 @@ Converts a standard [JSON Schema](https://json-schema.org/understanding-json-sch
 
 As of version 0.3.0, it is now advised to run a schema through a de-referencer like: https://apitools.dev/json-schema-ref-parser/ to properly deal with `$ref`.  I have removed my own poor implementation of de-referencing JSON schemas since there are libraries that can do it better than I can.
 
-It should be noted, that de-referencing libraries have their own issues and might not be able to properly parse your JSON.  Due to the way OpenAPI v3.0.X Schema Object's are handled, should the referencing not be 100% correct you might face issues using this library and it's output to be used with OpenAPI 3.0.X.
+It should be noted, that de-referencing libraries have their own issues and might not be able to properly parse your JSON/output a schema you might expect.  Due to the way OpenAPI v3.0.X Schema Object's are handled, should the referencing not be 100% correct you might face issues using this library and it's output to be used with OpenAPI 3.0.X.
 
 ## Conversions
 
 This attempts to massage the standard JSON Schema to a compatible OpenAPI v3.0.X Schema Object.  There are many properties that are not supported by OpenAPI v3.0.X Schema Object, though have now been supported by [OpenAPI v3.1.X](https://spec.openapis.org/oas/v3.1.0#schema-object).  This library should only be used if working with OpenAPI v3.0.X.
 
+### Items as an Array to Object
+
+This will convert a schema of:
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "type": "array",
+            "items": [
+                {
+                    "example2": {
+                        "type": "string"
+                    }
+                }
+            ]
+        }
+    }
+}
+```
+
+To:
+
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "type": "array",
+            "items": {
+                "example2": {
+                    "type": "string"
+                }
+            }
+        }
+    }
+}
+```
+
+### Types in an array to OneOf
+
+This will convert a schema of:
+
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "type": ["string", "number"],
+        }
+    }
+}
+```
+
+To:
+
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "oneOf": [
+                {
+                    "type": "string"
+                },
+                {
+                    "type": "number"
+                }
+            ]
+        }
+    }
+}
+```
+
+### Const to enum
+
+This will convert a schema of:
+
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "type": "string",
+            "const": "Surburbia"
+        }
+    }
+}
+```
+
+To:
+
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "type": "string",
+            "enum": ["Surburbia"]
+        }
+    }
+}
+```
+
+### null types
+
+OpenAPI 3.0.X does not allow for null as a type, so will convert a schema of:
+
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "type": "null",
+        }
+    }
+}
+```
+
+To:
+
+```json
+{
+    "type": "object",
+    "properties": {
+        "example": {
+            "nullable": true,
+        }
+    }
+}
+```
+
+### Default to their type
+
+This will convert the `"default":` value to the relevant type.  A String to a String, a Number/Integer to a number/Integer, a Boolean to a Boolean and try to manipulate an Object or an Array to either an Object or an Array
+
+### Dependencies, DependentRequired, DependentSchemas
+
+This will try to convert `"dependencies":`, `"dependentRequired":` and `"dependentSchemas":` to a valid `"allOf"` in the case of a `"dependentSchemas"` or an `"anyOf":` schema in the case of a `"dependentRequired"`.
+
+### If/Then/Else
+
+It will try to convert an If/Then/Else schema statement to a valid `"OneOf"` schema.
+
 ## Installation and Usage:
 
 Install via npm: `npm install json-schema-for-openapi`.