From d469f11280c8fc5b09169132baf3e9edb769c93c Mon Sep 17 00:00:00 2001
From: Solomon Hykes <solomon@dagger.io>
Date: Fri, 15 Apr 2022 18:50:26 -0500
Subject: [PATCH] Docs: split introduction & getting started sections

Signed-off-by: Solomon Hykes <solomon@dagger.io>
---
 .../1220-vs.md                                |  0
 docs/introduction/1235-what.md                | 26 +++++++++++++++++++
 website/sidebars.js                           | 15 ++++++++++-
 3 files changed, 40 insertions(+), 1 deletion(-)
 rename docs/{getting-started => introduction}/1220-vs.md (100%)
 create mode 100644 docs/introduction/1235-what.md

diff --git a/docs/getting-started/1220-vs.md b/docs/introduction/1220-vs.md
similarity index 100%
rename from docs/getting-started/1220-vs.md
rename to docs/introduction/1220-vs.md
diff --git a/docs/introduction/1235-what.md b/docs/introduction/1235-what.md
new file mode 100644
index 00000000..6f4a1b89
--- /dev/null
+++ b/docs/introduction/1235-what.md
@@ -0,0 +1,26 @@
+---
+slug: /1235/what
+displayed_sidebar: "0.2"
+---
+
+# What is Dagger?
+
+Dagger is a portable devkit for CICD.
+
+Using Dagger, software teams can develop powerful CICD pipelines with minimal effort, then run them anywhere.
+
+## Benefits
+
+Benefits of using Dagger include:
+
+* Unify dev and CI environments. Write your pipeline once, Dagger will run it the same everywhere.
+* Reduce CI lock-in. No more re-writing everything from scratch every 6 months.
+* Rapid debugging of your pipelines. Dagger runs equally well on your local machine, and in CI.
+
+## How does it work?
+
+1. Automate actions with your favorite programming language. No proprietary SDK: just regular shell, Go, Javascript, Python...
+2. Reuse actions from a large and growing catalog.
+3. Tie it all together in CUE - a revolutionary declarative language invented at Google. No more YAML hell!
+4. Test and debug instantly on your local machine. No more waiting 10min to catch a typo.
+5. Run your pipelines on any Docker-compatible runtime, for maximum portability. This means most modern CI runners can run Dagger out of the box.
diff --git a/website/sidebars.js b/website/sidebars.js
index b4e82d4a..707a71ce 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -11,6 +11,19 @@
 
 module.exports = {
   "0.2": [
+    {
+      type: "category",
+      label: "Introduction",
+      collapsible: false,
+      items: [
+	      "introduction/what",
+	      "introduction/vs",
+	],
+      link: {
+        type: 'generated-index',
+	title: "Dagger Documentation",
+      },
+    },
     {
       type: "category",
       label: "Getting Started",
@@ -19,7 +32,7 @@ module.exports = {
         type: 'doc',
         id: 'getting-started/index'
       },
-      items: ["getting-started/local-dev", "getting-started/ci-environment", "getting-started/vs"],
+      items: ["getting-started/local-dev", "getting-started/ci-environment"],
     },
     {
       type: "category",