Re-add "Getting Started" section

crate · Oct 26, 2023 · eabd37b · eabd37b
1 parent 22de6b3
commit eabd37b
Show file tree

Hide file tree

Showing 8 changed files with 31 additions and 17 deletions.
diff --git a/docs/handbook/create-user.rst → docs/getting-started/create-user.rst b/docs/handbook/create-user.rst → docs/getting-started/create-user.rst
diff --git a/docs/handbook/first-use.rst → docs/getting-started/first-use.rst b/docs/handbook/first-use.rst → docs/getting-started/first-use.rst
diff --git a/docs/getting-started/index.rst b/docs/getting-started/index.rst
@@ -0,0 +1,16 @@
+###############
+Getting Started
+###############
+
+A collection of CrateDB best practices and tips for common scenarios.
+
+.. rubric:: Table of contents
+
+.. toctree::
+    :maxdepth: 1
+
+    first-use
+    create-user
+    migrate/mysql
+    migrate/mongodb
+
diff --git a/docs/handbook/migrate/mongodb.rst → docs/getting-started/migrate/mongodb.rst b/docs/handbook/migrate/mongodb.rst → docs/getting-started/migrate/mongodb.rst
diff --git a/docs/handbook/migrate/mysql.rst → docs/getting-started/migrate/mysql.rst b/docs/handbook/migrate/mysql.rst → docs/getting-started/migrate/mysql.rst
diff --git a/docs/handbook/index.rst b/docs/handbook/index.rst
@@ -2,17 +2,14 @@
 Handbook
 ########
 
-A collection of CrateDB best practices and tips for common scenarios.
+A collection of CrateDB best practices and tips for common scenarios
+around the topics of sharding, partitioning, and performance tuning.
 
 .. rubric:: Table of contents
 
 .. toctree::
     :maxdepth: 1
 
-    first-use
-    create-user
     sharding-partitioning
     performance/index
-    migrate/mysql
-    migrate/mongodb
 
diff --git a/docs/handbook/sharding-partitioning.rst b/docs/handbook/sharding-partitioning.rst
@@ -1,8 +1,8 @@
 .. _sharding-partitioning:
 
-===============================
-About Sharding and Partitioning
-===============================
+#########################
+Sharding and Partitioning
+#########################
 
 .. rubric:: Table of contents
 

diff --git a/docs/index.rst b/docs/index.rst
@@ -21,15 +21,16 @@ massive amounts of machine data in real-time.
 .. rubric:: Table of contents
 
 .. toctree::
-   :maxdepth: 3
-   :titlesonly:
-
-   admin/index
-   handbook/index
-   reference-architectures/index
-   t/analysis/index
-   t/timeseries/index
-   t/ml/index
+    :maxdepth: 3
+    :titlesonly:
+
+    getting-started/index
+    admin/index
+    handbook/index
+    reference-architectures/index
+    t/analysis/index
+    t/timeseries/index
+    t/ml/index
 
 
 .. _Tutorials: https://crate.io/docs/crate/tutorials/en/latest/