Spacetime revamp (#2880)

* move and rename logs * update cases wording * Add new getting started section (WIP) * Fix broken link * In progress changes * Rename splunk file * move UI content to observabilty intro page * delete UI page and remove from index * Add changes from review * Fix broken link * add rough draft svg diagrams * fix link * moar diagram stuffs * update with review suggestions * Remove standalone tip * Remove old files * colab diagram * Update docs/en/observability/user-experience.asciidoc * Add overview for getting started topics * use svg not asciidoc * update overview diagram * Apply suggestions from code review --------- Co-authored-by: dedemorton <[email protected]> Co-authored-by: mdbirnstiehl <[email protected]> (cherry picked from commit df0901d)
elastic · May 1, 2023 · 0b1e12d · 0b1e12d
1 parent 2582148
commit 0b1e12d
Show file tree

Hide file tree

Showing 29 changed files with 294 additions and 1,104 deletions.
diff --git a/docs/en/observability/add-observability-data.asciidoc b/docs/en/observability/add-observability-data.asciidoc
diff --git a/docs/en/observability/application-logs.asciidoc b/docs/en/observability/application-logs.asciidoc
@@ -1,5 +1,5 @@
 [[application-logs]]
-= Application logs
+= Monitor application logs
 
 Application logs provide valuable insight into events that have occurred within your services and applications.
 

diff --git a/docs/en/observability/create-cases.asciidoc b/docs/en/observability/create-cases.asciidoc
@@ -1,10 +1,10 @@
 [[create-cases]]
 = Cases
 
-Cases are used to open and track observability issues directly in the Elastic
-{observability} app. You can add assignees and tags to your cases, set their
-severity and status, and add alerts, comments, and visualizations. You can also
-send cases to third party systems by
+Collect and share information about observability issues by opening a case directly
+in the Elastic {observability} app. Cases allow you to track key investigation details,
+add assignees and tags to your cases, set their severity and status, and add alerts,
+comments, and visualizations. You can also send cases to third party systems by
 <<cases-external-connectors,configuring external connectors>>.
 
 [role="screenshot"]

diff --git a/docs/en/observability/deploy-agent-to-send-data.asciidoc b/docs/en/observability/deploy-agent-to-send-data.asciidoc
diff --git a/docs/en/observability/deploy-beats-to-send-data.asciidoc b/docs/en/observability/deploy-beats-to-send-data.asciidoc
diff --git a/docs/en/observability/gcp-dataflow.asciidoc b/docs/en/observability/gcp-dataflow.asciidoc
@@ -19,7 +19,6 @@ view those logs in {kib}.
 Create a deployment using our hosted {ess} on {ess-trial}[{ecloud}].
 The deployment includes an {es} cluster for storing and searching your data,
 and {kib} for visualizing and managing your data.
-For more information, see <<spin-up-stack,Spin up the {stack}>>.
 
 [discrete]
 ==== Step 1: Install the GCP integration 

diff --git a/docs/en/observability/images/get-started.svg b/docs/en/observability/images/get-started.svg
diff --git a/docs/en/observability/images/what-is-observability.svg b/docs/en/observability/images/what-is-observability.svg
diff --git a/docs/en/observability/index.asciidoc b/docs/en/observability/index.asciidoc
@@ -26,7 +26,7 @@ include::{docs-root}/shared/attributes.asciidoc[]
 :apm-repo-dir:         {apm-server-root}/docs
 :beats-repo-dir:       {beats-root}/libbeat/docs
 :shared:               {observability-docs-root}/docs/en/shared
-:kibana-repo-dir:      {kibana-root}/docs 
+:kibana-repo-dir:      {kibana-root}/docs
 
 :synthetics_version: v1.0.0-beta.40
 :project-monitors: project monitors
@@ -40,38 +40,22 @@ include::observability-introduction.asciidoc[leveloffset=+1]
 // What's new
 include::whats-new.asciidoc[leveloffset=+1]
 
-// Send data to Elasticsearch
-include::add-observability-data.asciidoc[leveloffset=+1]
+// Get started with Elastic Observability
+include::observability-get-started.asciidoc[leveloffset=+1]
 
-include::spin-up-stack.asciidoc[leveloffset=+2]
+include::logs-metrics-get-started.asciidoc[leveloffset=+2]
 
-include::deploy-agent-to-send-data.asciidoc[leveloffset=+2]
+//TOOD: Rename this file to traces-get-started in a follow-on PR
+include::ingest-traces.asciidoc[leveloffset=+2]
 
-include::ingest-logs-metrics-uptime.asciidoc[leveloffset=+3]
-
-include::ingest-traces.asciidoc[leveloffset=+3]
-
-include::ingest-splunk.asciidoc[leveloffset=+3]
-
-include::deploy-beats-to-send-data.asciidoc[leveloffset=+2]
-
-include::ingest-logs.asciidoc[leveloffset=+3]
-
-include::ingest-metrics.asciidoc[leveloffset=+3]
-
-include::ingest-uptime.asciidoc[leveloffset=+3]
-
-include::instrument-apps.asciidoc[leveloffset=+3]
-
-// Observability overview page
-include::observability-ui.asciidoc[leveloffset=+1]
+include::splunk-get-started.asciidoc[leveloffset=+2]
 
 // APM
 include::apm.asciidoc[leveloffset=+1]
 
-// Logs
-include::application-logs.asciidoc[leveloffset=+1]
+include::application-logs.asciidoc[leveloffset=+2]
 
+// Logs
 include::monitor-logs.asciidoc[leveloffset=+1]
 
 include::tail-logs.asciidoc[leveloffset=+2]

diff --git a/docs/en/observability/ingest-logs.asciidoc b/docs/en/observability/ingest-logs.asciidoc