Added enum mapping documentation

website/src/_data/navigation.json

@@ -19,6 +19,26 @@
           "caption": "Introduction",
           "url": "/getting-started/introduction/",
           "external": false
+        },
+        {
+          "caption": "Installation",
+          "url": "/getting-started/installation/",
+          "external": false
+        }
+      ]
+    },
+    {
+      "title": "Usage",
+      "items": [
+        {
+          "caption": "Object Mapping",
+          "url": "/usage/object-mapping/",
+          "external": false
+        },
+        {
+          "caption": "Enum Mapping",
+          "url": "/usage/enum-mapping/",
+          "external": false
         }
       ]
     }

website/src/posts/usage/posts/enum-mapping.md

@@ -0,0 +1,40 @@
+---
+title: "Enum Mapping"
+summary: "Performing enum mapping."
+eleventyNavigation:
+  key: Enum Mapping
+  parent: Usage
+  order: 2
+---
+
+# Summary
+Mappie supports creating enum mappers via the base class `EnumMapper`.
+
+Suppose we have an enum class `Color`
+```kotlin
+enum class Color { RED, GREEN, BLUE; }
+```
+and an enum class `Colour`
+```kotlin
+enum class Colour { RED, GREEN, GLUE; }
+```
+The entries of both are identical, so we do not have to declare any mapping explicitly
+```kotlin
+object ColorMapper : EnumMapper<Color, Colour>() {
+    override fun map(from: Color): Colour = mapping()
+}
+```
+
+Now suppose `Color`{:.kotlin} has an extra entry: `Color.ORANGE`, whilst `Colour` does
+not have `Colour.ORANGE`, but does have `Colour.OTHER`. We can map `Colour.ORANGE` to `Colour.OTHER` via
+
+```kotlin
+object ColorMapper : EnumMapper<Color, Colour>() {
+    override fun map(from: Color): Colour = mapping {
+        Colour.OTHER mappedFromEnumEntry Color.ORANGE
+    }
+}
+```
+
+# Configuration options
+

website/src/posts/mapping/posts/object-mapping.md → website/src/posts/usage/posts/object-mapping.md

@@ -1,9 +1,9 @@
 ---
-title: "Object mapping"
+title: "Object Mapping"
 summary: "Performing object mapping."
 eleventyNavigation:
-  key: ObjectMapping
-  parent: Mapping
+  key: Object Mapping
+  parent: Usage
   order: 1
 ---
 

website/src/posts/usage/posts/posts.json

@@ -0,0 +1,4 @@
+{
+  "layout": "layouts/post.html",
+  "permalink": "/usage/{{ title | slug }}/index.html"
+}

website/src/posts/mapping/mapping.md → website/src/posts/usage/usage.md

@@ -1,6 +1,6 @@
 ---
-title: "Mapping"
+title: "Usage"
 eleventyNavigation:
-  key: Mapping
+  key: Usage
   order: 2
 ---