[docs] Docs navigation improvements (#769)

* [docs] Docs navigation improvements: - Added a new list page for the how-to section - Make 'GET STARTED' main menu item a drop down.
cloudprober · Jun 10, 2024 · 5719d19 · 5719d19
1 parent 2cb5350
commit 5719d19
Show file tree

Hide file tree

Showing 4 changed files with 41 additions and 4 deletions.
diff --git a/docs/config/_default/menus/menus.toml b/docs/config/_default/menus/menus.toml
@@ -4,6 +4,24 @@
   url = "/docs/overview/cloudprober"
   weight = 30
 
+[[main]]
+  name = "Overview"
+  weight = 31
+  url = "/docs/overview/cloudprober"
+  parent = "get-started"
+
+[[main]]
+  name = "Getting Started"
+  weight = 32
+  url = "/docs/overview/getting-started"
+  parent = "get-started"
+
+[[main]]
+  name = "What is a Probe"
+  weight = 33
+  url = "/docs/overview/probe"
+  parent = "get-started"
+
 [[main]]
   name = "Configuration"
   weight = 40
@@ -14,7 +32,7 @@
   name = "How-To"
   weight = 60
   identifier = "how-to"
-  url = "/docs/how-to/external-probe"
+  url = "/docs/how-to/list/"
 
 [[main]]
   name = "Surfacers"
@@ -57,7 +75,7 @@
 [[docs]]
   name = "How-To"
   identifier = "how-to"
-  url = "/docs/how-to/external-probe"
+  url = "/docs/how-to/list/"
   weight = 30
 
 [[docs]]

diff --git a/docs/content/docs/how-to/built-in-servers.md b/docs/content/docs/how-to/built-in-servers.md
@@ -2,7 +2,7 @@
 menu:
   docs:
     parent: "how-to"
-    weight: 32
+    weight: 40
 title: "Built-in Servers"
 ---
 

diff --git a/docs/content/docs/how-to/extensions.md b/docs/content/docs/how-to/extensions.md
@@ -2,7 +2,7 @@
 menu:
   docs:
     parent: "how-to"
-    weight: 40
+    weight: 32
 title: "Extending Cloudprober"
 ---
 

diff --git a/docs/content/docs/how-to/list/index.md b/docs/content/docs/how-to/list/index.md
@@ -0,0 +1,19 @@
+---
+title: "How Tos"
+lead: ""
+draft: false
+images: []
+weight: 100
+---
+
+- [External Probe]({{< ref "external-probe" >}})
+- [Alerting]({{< ref "alerting" >}})
+- [Targets]({{< ref "targets" >}})
+- [Kubernetes Targets]({{< ref "k8s_targets" >}})
+- [Running on Kubernetes]({{< ref "run-on-kubernetes" >}})
+- [Additional Labels]({{< ref "additional-labels" >}})
+- [Validators]({{< ref "validators" >}})
+- [Percentiles and Histograms]({{< ref "percentiles" >}})
+- [Extending Cloudprober]({{< ref "extensions" >}})
+- [Built-in Servers]({{< ref "built-in-servers" >}})
+- [Resource Discovery Service]({{< ref "rds" >}})