Docs: combine "user manual" and "programming manual" into "learn dagger"

Signed-off-by: Solomon Hykes <solomon@dagger.io>
dagger · Jun 15, 2021 · 9690981 · 9690981
1 parent 71c3655
commit 9690981
Show file tree

Hide file tree

Showing 7 changed files with 25 additions and 22 deletions.
diff --git a/docs/user/user.md → docs/learn/101-use.md b/docs/user/user.md → docs/learn/101-use.md
@@ -1,12 +1,18 @@
 ---
-slug: /user
+slug: /learn/101-basics
 ---
 
-# User Manual
+# Dagger 101: basic usage
 
-In this part, you will learn how to deploy a simple [React](https://reactjs.org/) application. This is an introduction before you [learn how to program dagger](/programming).
+In this guide, you will learn the basics of Dagger by interacting with a pre-configured environment.
+Then you will move on to creating your own environment from scratch.
 
-You will learn how to use the most common dagger commands.
+Our pre-configured environment deploys a simple [React](https://en.wikipedia.org/wiki/React_(JavaScript_library))
+application to a special hosting environment created and managed by us, the Dagger team for the purpose of this tutorial.
+This will allow you to deploy something "real" right away, without having to configure your own infrastructure first.
+
+In later guides, you will learn how to configure Dagger to deploy to your own infrastructure. And, for advanced users,
+how to share access to your infrastructure in the same way that we are sharing access to ours now.
 
 ## Before we start
 

diff --git a/docs/programming/programming.md → docs/learn/102-dev.md b/docs/programming/programming.md → docs/learn/102-dev.md
@@ -1,9 +1,8 @@
 ---
-sidebar_position: 1
-slug: /programming
+slug: /learn/102-dev
 ---
 
-# Dagger 102: learn to program Dagger
+# Dagger 102: create your first environment
 
 ## Overview
 

diff --git a/docs/programming/guides/kubernetes.md → docs/learn/107-kubernetes.md b/docs/programming/guides/kubernetes.md → docs/learn/107-kubernetes.md
@@ -1,4 +1,8 @@
-# Kubernetes
+---
+slug: /learn/107-kubernetes
+---
+
+# Dagger 107: deploy to Kubernetes
 
 This tutorial illustrates how to use dagger to build, push and deploy Docker
 images to Kubernetes.

diff --git a/docs/programming/guides/cloudformation.mdx → docs/learn/108-cloudformation.mdx b/docs/programming/guides/cloudformation.mdx → docs/learn/108-cloudformation.mdx
@@ -1,8 +1,12 @@
-# Infra provisioning
+---
+slug: /learn/108-cloudformation
+---
 
-## Integrating with AWS Cloudformation
+# Dagger 108: provision infrastructure on AWS
 
-After deploying the app on a bucket provisioned from the web interface, let's see how Dagger can be leveraged to extend our deployment pipeline using Cloudformation's relay.
+In this guide you will learn how to automatically [provision infrastructure](https://dzone.com/articles/infrastructure-provisioning-–) on AWS, by integrating [Amazon Cloudformation](https://aws.amazon.com/cloudformation/) in your Dagger environment.
+
+We will start with something simple: provisioning a new bucket on [Amazon S3](https://en.wikipedia.org/wiki/Amazon_S3). But Cloudformation can provision almost any AWS resource; and Dagger can integrate with the full Cloudformation API.
 
 ## Prerequisites
 

diff --git a/docs/user/_category_.json → docs/learn/_category_.json b/docs/user/_category_.json → docs/learn/_category_.json
@@ -1,5 +1,5 @@
 {
-  "label": "User Manual",
+  "label": "Learn Dagger",
   "position": 3,
   "collapsed": false
 }
diff --git a/docs/programming/_category_.json b/docs/programming/_category_.json
diff --git a/docs/programming/guides/_category_.json b/docs/programming/guides/_category_.json