From 24b59505d0d978f54a0fe049bbe1a203e928dddb Mon Sep 17 00:00:00 2001
From: "r.bideau" <7304827+rbideau@users.noreply.github.com>
Date: Sun, 21 Feb 2021 20:41:44 +0100
Subject: [PATCH] Moves google analytics docs in an integration section

- with a link to it in the observability page.
- documents the default behavior and add a link to the GA developer guides

Signed-off-by: r.bideau <7304827+rbideau@users.noreply.github.com>
---
 .../google-analytics/installation.md          | 23 +++++++++++++++++++
 docs/plugins/observability.md                 | 14 ++---------
 2 files changed, 25 insertions(+), 12 deletions(-)
 create mode 100644 docs/integrations/google-analytics/installation.md

diff --git a/docs/integrations/google-analytics/installation.md b/docs/integrations/google-analytics/installation.md
new file mode 100644
index 0000000000..759cfa3ed1
--- /dev/null
+++ b/docs/integrations/google-analytics/installation.md
@@ -0,0 +1,23 @@
+---
+id: installation
+title: Google Analytics Installation
+# prettier-ignore
+description: Adding Google Analytics to Your App
+---
+
+There is a basic Google Analytics integration built into Backstage. You can
+enable it by adding the following to your app configuration:
+
+```yaml
+app:
+  googleAnalyticsTrackingId: UA-000000-0
+```
+
+Replace the tracking ID with your own.
+
+For more information, learn about Google Analytics
+[here](https://marketingplatform.google.com/about/analytics/).
+
+The default behavior is only to send a pageview hit to Google Analytics. To
+record more, look at the developer documentation
+[here](https://developers.google.com/analytics/devguides/collection/gtagjs).
diff --git a/docs/plugins/observability.md b/docs/plugins/observability.md
index 8b6668606f..de6f4bf988 100644
--- a/docs/plugins/observability.md
+++ b/docs/plugins/observability.md
@@ -10,18 +10,8 @@ Backstage integrator.
 
 ## Google Analytics
 
-There is a basic Google Analytics integration built into Backstage. You can
-enable it by adding the following to your app configuration:
-
-```yaml
-app:
-  googleAnalyticsTrackingId: UA-000000-0
-```
-
-Replace the tracking ID with your own.
-
-For more information, learn about Google Analytics
-[here](https://marketingplatform.google.com/about/analytics/).
+See how to install Google Analytics in your app
+[here](../integrations/google-analytics/installation.md)
 
 ## Logging