diff --git a/docs/build-options/intro.md b/docs/build-options/intro.md
index f418a963cebc38fe1947b909e5ceb57a0dea8aea..5af9ff7aaae9281a2be359733196feb459397d15 100644
--- a/docs/build-options/intro.md
+++ b/docs/build-options/intro.md
@@ -1,5 +1,10 @@
 ---
 title: Build Options
+items:
+  - { type: file, name: enabling-flags.md }
+  - { type: file, name: disabling-flags.md }
+  - { type: file, name: platform-spec.md }
+  - { type: file, name: tunables.md }
 ---
 
 Mongoose source code ships in a single .c file that contains functionality
diff --git a/docs/build-options/items.json b/docs/build-options/items.json
deleted file mode 100644
index 2d8c57bdc368137bb90efbaf843156621981bf6f..0000000000000000000000000000000000000000
--- a/docs/build-options/items.json
+++ /dev/null
@@ -1,9 +0,0 @@
-{
-  "items": [
-    { "type": "markdown", "name": "intro.md" },
-    { "type": "markdown", "name": "enabling-flags.md" },
-    { "type": "markdown", "name": "disabling-flags.md" },
-    { "type": "markdown", "name": "platform-spec.md" },
-    { "type": "markdown", "name": "tunables.md" }
-  ]
-}
diff --git a/docs/design-concept/intro.md b/docs/design-concept/intro.md
index 2142b62fdeb510dbdf6da00a8a7f08c884d502ce..b0cd08ae5dd46c21608b481fe5aab40a0631ec25 100644
--- a/docs/design-concept/intro.md
+++ b/docs/design-concept/intro.md
@@ -1,5 +1,10 @@
 ---
 title: Design Concept
+items:
+  - { type: file, name: memory-buffers.md }
+  - { type: file, name: event-handler.md }
+  - { type: file, name: events.md }
+  - { type: file, name: conn-flags.md }
 ---
 
 Mongoose is a multi-protocol networking library that implements non-blocking,
diff --git a/docs/design-concept/items.json b/docs/design-concept/items.json
deleted file mode 100644
index c939cbe9bd8b1407b86e50ce65bb33ed41b7fa77..0000000000000000000000000000000000000000
--- a/docs/design-concept/items.json
+++ /dev/null
@@ -1,9 +0,0 @@
-{
-  "items": [
-    { "type": "markdown", "name": "intro.md" },
-    { "type": "markdown", "name": "memory-buffers.md" },
-    { "type": "markdown", "name": "event-handler.md" },
-    { "type": "markdown", "name": "events.md" },
-    { "type": "markdown", "name": "conn-flags.md" }
-  ]
-}
diff --git a/docs/intro.md b/docs/intro.md
new file mode 100644
index 0000000000000000000000000000000000000000..3f8a8f5fdd082e8cf1c57cdc8e87e83035f0accc
--- /dev/null
+++ b/docs/intro.md
@@ -0,0 +1,14 @@
+---
+title: Mongoose - a networking library
+color: '#1D6482'
+repo: https://github.com/cesanta/mongoose
+items:
+  - { type: dir, name: usage-example }
+  - { type: dir, name: design-concept }
+  - { type: dir, name: build-options }
+  - { type: flat, name: c-api }
+---
+
+Mongoose is a multi-protocol embedded networking library with
+that implements TCP, UDP, HTTP, WebSocket, CoAP, MQTT, JSON-RPC,
+both client and server mode.
diff --git a/docs/items.json b/docs/items.json
deleted file mode 100644
index 7360d0150f9fdacc3fe79415d9679e66e5d107cb..0000000000000000000000000000000000000000
--- a/docs/items.json
+++ /dev/null
@@ -1,8 +0,0 @@
-{
-  "items": [
-    { "type": "section", "name": "usage-example" },
-    { "type": "section", "name": "design-concept" },
-    { "type": "section", "name": "build-options" },
-    { "type": "flat_sections_set", "name": "c-api" }
-  ]
-}
diff --git a/docs/usage-example/items.json b/docs/usage-example/items.json
deleted file mode 100644
index bc7e70d8d0e561c3c4545aeb1aa07f6688f31bce..0000000000000000000000000000000000000000
--- a/docs/usage-example/items.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
-  "items": [
-    { "type": "markdown", "name": "intro.md" }
-  ]
-}