[Docs] Rename / add a welcome page

This should become more welcoming though..
input-output-hk · May 6, 2024 · 321f2dc · 321f2dc
1 parent 1292efc
commit 321f2dc
Show file tree

Hide file tree

Showing 4 changed files with 17 additions and 10 deletions.
diff --git a/docs/docs/dev/index.md b/docs/docs/dev/index.md
@@ -0,0 +1,11 @@
+---
+sidebar_position: 1
+---
+
+# About Hydra
+
+So you read already the [User Manual](../index.md) and still want to learn more about the Hydra protocol, its inner workings and how it is implemented?
+
+Look no further...
+
+<!-- TODO: complete intro -->
diff --git a/docs/docs/getting-started/index.md → docs/docs/index.md b/docs/docs/getting-started/index.md → docs/docs/index.md
@@ -1,10 +1,6 @@
----
-sidebar_position: 1
----
+# Welcome
 
-# Getting Started
-
-Hydra is the layer-two scalability solution for Cardano, which aims to increase
+Hydra is a layer-two scalability solution for Cardano, which aims to increase
 the speed of transactions (low latency, high throughput) and minimize
 transaction cost.
 
@@ -39,5 +35,5 @@ see also sections 7, 8 and 9 of the [Apache 2.0 License][license].
 
 :::
 
-[known-issues]: ../known-issues
+[known-issues]: ./known-issues.md
 [license]: https://github.com/input-output-hk/hydra/blob/master/LICENSE
diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js
@@ -156,12 +156,12 @@ const config = {
         },
         items: [
           {
-            to: "/docs/getting-started",
+            to: "/docs",
             label: "User Manual",
             position: "left",
           },
           {
-            to: "/docs/dev/overview",
+            to: "/docs/dev",
             label: "Developer Documentation",
             position: "left",
           },

diff --git a/docs/sidebars.js b/docs/sidebars.js
@@ -3,7 +3,7 @@ module.exports = {
     {
       type: "doc",
       label: "Welcome",
-      id: "getting-started/index",
+      id: "index",
     },
     {
       type: "doc",