docs: restructure getting-started section (keptn#2294)

Signed-off-by: Meg McRoberts <[email protected]>
Signed-off-by: Moritz Wiesinger <[email protected]>
Co-authored-by: Moritz Wiesinger <[email protected]>
Co-authored-by: odubajDT <[email protected]>

docs/content/en/docs/tutorials/tasks/_index.md → docs/content/en/docs/getting-started/tasks/_index.md

@@ -1,8 +1,7 @@
 ---
-title: Getting started with Release Lifecycle Management
+title: Release Lifecycle Management
 description: Add KeptnTasks to deployments
-weight: 25
-hidechildren: false # this flag hides all sub-pages in the sidebar-multicard.html
+weight: 50
 ---
 
 The Release Lifecycle Management tools run
@@ -151,7 +150,8 @@ Incidentally, this is exactly how you can use Keptn with [applications deployed
 
 Annotate the demo application `Deployment` manifest to have Keptn automatically trigger the task after every deployment.
 
-Recall the `Deployment` from the [getting started guide](../../getting-started/_index.md#step-3-deploy-demo-application).
+Recall the `Deployment` from the [Observability](../../getting-started/observability/_index.md#step-3-deploy-demo-application)
+Getting started guide.
 
 Add a new label so the `labels` section looks like this:
 

docs/content/en/docs/intro/usecase_metrics.md → docs/content/en/docs/getting-started/usecase_metrics.md

@@ -1,10 +1,10 @@
 ---
-title: Custom Keptn metrics
+title: Keptn metrics
 description: Enhance your deployment with custom Keptn metrics
 weight: 30
 ---
 
-The Custom Keptn metrics component
+The Keptn metrics component
 allows you to define any type of metric
 from multiple instances
 of any type of data source in your Kubernetes cluster.
@@ -29,7 +29,7 @@ Each has plugins but it is difficult to maintain them,
 especially if you are using multiple tools,
 and multiple observability platforms,
 and multiple instances of some tools or observability platforms.
-The Custom Keptn metrics feature unites all these metrics
+The Keptn metrics feature unites all these metrics
 integrates metrics from all these sources into a single set of metrics.
 
 ## Using this exercise
@@ -48,11 +48,11 @@ series.
 After completing this exercise,
 you may want to do the other exercises:
 
-- In [Standardize observability](usecase-observability.md),
+- In [Standardize observability](../intro/usecase-observability.md),
   you learn how to standardize access
   to the observability data for your cluster.
 - In
-  [Manage release lifecycle](usecase-orchestrate.md),
+  [Manage release lifecycle](../intro/usecase-orchestrate.md),
   you learn how to implement
   pre- and post-deployment tasks and evaluations
   to orchestrate the flow of all the `workloads`

docs/content/en/docs/implementing/evaluatemetrics.md

@@ -16,7 +16,7 @@ or another standard dashboard application that you configure
 or can be retrieved using standard Kubernetes commands.
 
 For an introduction to Keptn metrics, see
-[Getting started with Keptn metrics](../intro/usecase_metrics.md).
+[Getting started with Keptn metrics](../getting-started/usecase_metrics.md).
 
 ## Keptn metric basics
 

docs/content/en/docs/intro/_index.md

@@ -47,7 +47,7 @@ simplifying configuration and integration into a single set of metrics.
 
 To learn more, see:
 
-* [Custom Keptn metrics](usecase_metrics.md)
+* [Keptn metrics](../getting-started/usecase_metrics.md) getting started guide
 * [Keptn Metrics](../implementing/evaluatemetrics.md) guide
 
 ## Observability
@@ -86,7 +86,7 @@ to ensure that your deployments are observable.
 
 To learn more, see:
 
-* [Getting started with Keptn Observability](../getting-started)
+* [Getting started with Keptn Observability](../getting-started/observability)
 * [Standardize observability](usecase-observability.md/)
 * [DORA metrics](../implementing/dora) guide
 * [OpenTelemetry observability](../implementing/otel.md) guide
@@ -134,15 +134,15 @@ or a
 which is a single, cohesive unit that groups multiple workloads.
 For more information, see:
 
-* [Keptn tasks](../implementing/tasks)
-* [Evaluations](../implementing/evaluations.md)
+* [Keptn tasks](../implementing/tasks) guide
+* [Evaluations](../implementing/evaluations.md) guide
 * [KeptnApp and KeptnWorkflow resources](../architecture/keptn-apps)
 
 ## Next steps
 
 To learn more, see:
 
-* [Getting started with release lifecycle management](../tutorials/tasks/)
+* [Getting started with release lifecycle management](../getting-started/tasks/)
 * [Manage release lifecycle](usecase-orchestrate.md)
-* [Deployment tasks](../implementing/tasks)
-* [Evaluations](../implementing/evaluations.md)
+* [Deployment tasks](../implementing/tasks) guide
+* [Evaluations](../implementing/evaluations.md) guide

docs/content/en/docs/intro/usecase-observability.md

@@ -47,7 +47,7 @@ This is the second of three exercises in the
 series:
 
 - In the
-  [Getting started with Keptn metrics](usecase_metrics.md)
+  [Getting started with Keptn metrics](../getting-started/usecase_metrics.md)
   exercise, you learn how to define and use Keptn metrics.
   You may want to complete that exercise before doing this exercise
   although that is not required.
@@ -116,7 +116,7 @@ which allows you to trace everything done in the context of that deployment.
 You can supplement the DORA Metrics and OpenTelemetry information
 with information you explicitly define using Keptn metrics.
 The
-[Getting started with Keptn metrics](usecase_metrics.md)
+[Getting started with Keptn metrics](../getting-started/usecase_metrics.md)
 exercise discusses how to define Keptn metrics.
 
 ## View the results

docs/content/en/docs/intro/usecase-orchestrate.md

@@ -29,7 +29,7 @@ and can do the following:
 * Validate any Keptn metric,
   either pre- or post-deployment,
   using the metrics from the Keptn Metrics Server introduced in
-  [Getting started with Keptn metrics](usecase_metrics.md).
+  [Getting started with Keptn metrics](../getting-started/usecase_metrics.md).
 
 This means that you can be sure that the environment is healthy
 and has adequate resources before you begin the deployment.
@@ -62,7 +62,7 @@ You may want to complete the other exercises before doing this exercise
 although that is not required:
 
 * In the
-  [Getting started with Keptn metrics](usecase_metrics.md)
+  [Getting started with Keptn metrics](../getting-started/usecase_metrics.md)
   exercise, you learn how to define and use Keptn metrics.
 * In [Standardize observability](usecase-observability.md),
   you learn how to standardize access

docs/content/en/docs/yaml-crd-ref/metric.md

@@ -156,5 +156,5 @@ spec:
 * [KeptnEvaluationDefinition](evaluationdefinition.md)
 * [KeptnMetricsProvider](metricsprovider.md)
 * Implementing [Keptn Metrics](../implementing/evaluatemetrics.md)
-* [Getting started with Keptn metrics](../intro/usecase_metrics.md)
+* [Getting started with Keptn metrics](../getting-started/usecase_metrics.md)
 * Architecture of the [Keptn Metrics Operator](../architecture/components/metrics-operator/_index.md)