From b76e877bcf2de9ffcea62d5b49183587ce6b0aed Mon Sep 17 00:00:00 2001
From: Evan Kelly <Evan.Kelly@fmr.com>
Date: Tue, 18 Jun 2024 14:40:41 +0100
Subject: [PATCH 1/7] added script for datadog script to docs

Signed-off-by: Evan Kelly <Evan.Kelly@fmr.com>
---
 docs/integrations/datadog-rum/installation.md | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/docs/integrations/datadog-rum/installation.md b/docs/integrations/datadog-rum/installation.md
index 4dc6c24134..b5f2a494c9 100644
--- a/docs/integrations/datadog-rum/installation.md
+++ b/docs/integrations/datadog-rum/installation.md
@@ -36,3 +36,48 @@ There are two optional arguments:
 
 - `site`: The Datadog site of your organization; defaults to `datadoghq.com`
 - `env`: The application environment for Datadog events (no default)
+
+## Script to fix Datadog RUM not Publishing Issue
+
+Copy and paste this section to your `packages/app/public/index.html`
+
+```
+<% if (config.has('app.datadogRum')) { %> 
+ <script> 
+   (function (h, o, u, n, d) { 
+     h = h[d] = h[d] || { 
+       q: [], 
+       onReady: function (c) { 
+         h.q.push(c); 
+       }, 
+     }; 
+     d = o.createElement(u); 
+     d.async = 1; 
+     d.src = n; 
+     n = o.getElementsByTagName(u)[0]; 
+     n.parentNode.insertBefore(d, n); 
+   })( 
+     window, 
+     document, 
+     'script', 
+     'https://www.datadoghq-browser-agent.com/datadog-rum-v3.js', 
+     'DD_RUM', 
+   ); 
+   DD_RUM.onReady(function () { 
+     DD_RUM.init({ 
+       clientToken: '<%= config.getString("app.datadogRum.clientToken") %>', 
+       applicationId: 
+         '<%= config.getString("app.datadogRum.applicationId") %>', 
+       site: '<%= config.getOptionalString("app.datadogRum.site") || "datadoghq.com" %>', 
+       service: 'backstage', 
+       env: '<%= config.getString("app.datadogRum.env") %>', 
+       sampleRate: 
+         '<%= config.getOptionalNumber("app.datadogRum.sessionSampleRate") || 100 %>', 
+       sessionReplaySampleRate: 
+         '<%= config.getOptionalNumber("app.datadogRum.sessionReplaySampleRate") || 0 %>', 
+       trackInteractions: true, 
+     }); 
+   }); 
+ </script> 
+ <% } %> 
+```

From 09d7e3f1d9d813655b286c280bb80044946d870a Mon Sep 17 00:00:00 2001
From: Evan Kelly <Evan.Kelly@fmr.com>
Date: Wed, 26 Jun 2024 14:14:09 +0100
Subject: [PATCH 2/7] run prettier check

Signed-off-by: Evan Kelly <Evan.Kelly@fmr.com>
---
 docs/integrations/datadog-rum/installation.md | 76 +++++++++----------
 1 file changed, 38 insertions(+), 38 deletions(-)

diff --git a/docs/integrations/datadog-rum/installation.md b/docs/integrations/datadog-rum/installation.md
index b5f2a494c9..1301f111f7 100644
--- a/docs/integrations/datadog-rum/installation.md
+++ b/docs/integrations/datadog-rum/installation.md
@@ -42,42 +42,42 @@ There are two optional arguments:
 Copy and paste this section to your `packages/app/public/index.html`
 
 ```
-<% if (config.has('app.datadogRum')) { %> 
- <script> 
-   (function (h, o, u, n, d) { 
-     h = h[d] = h[d] || { 
-       q: [], 
-       onReady: function (c) { 
-         h.q.push(c); 
-       }, 
-     }; 
-     d = o.createElement(u); 
-     d.async = 1; 
-     d.src = n; 
-     n = o.getElementsByTagName(u)[0]; 
-     n.parentNode.insertBefore(d, n); 
-   })( 
-     window, 
-     document, 
-     'script', 
-     'https://www.datadoghq-browser-agent.com/datadog-rum-v3.js', 
-     'DD_RUM', 
-   ); 
-   DD_RUM.onReady(function () { 
-     DD_RUM.init({ 
-       clientToken: '<%= config.getString("app.datadogRum.clientToken") %>', 
-       applicationId: 
-         '<%= config.getString("app.datadogRum.applicationId") %>', 
-       site: '<%= config.getOptionalString("app.datadogRum.site") || "datadoghq.com" %>', 
-       service: 'backstage', 
-       env: '<%= config.getString("app.datadogRum.env") %>', 
-       sampleRate: 
-         '<%= config.getOptionalNumber("app.datadogRum.sessionSampleRate") || 100 %>', 
-       sessionReplaySampleRate: 
-         '<%= config.getOptionalNumber("app.datadogRum.sessionReplaySampleRate") || 0 %>', 
-       trackInteractions: true, 
-     }); 
-   }); 
- </script> 
- <% } %> 
+<% if (config.has('app.datadogRum')) { %>
+ <script>
+   (function (h, o, u, n, d) {
+     h = h[d] = h[d] || {
+       q: [],
+       onReady: function (c) {
+         h.q.push(c);
+       },
+     };
+     d = o.createElement(u);
+     d.async = 1;
+     d.src = n;
+     n = o.getElementsByTagName(u)[0];
+     n.parentNode.insertBefore(d, n);
+   })(
+     window,
+     document,
+     'script',
+     'https://www.datadoghq-browser-agent.com/datadog-rum-v3.js',
+     'DD_RUM',
+   );
+   DD_RUM.onReady(function () {
+     DD_RUM.init({
+       clientToken: '<%= config.getString("app.datadogRum.clientToken") %>',
+       applicationId:
+         '<%= config.getString("app.datadogRum.applicationId") %>',
+       site: '<%= config.getOptionalString("app.datadogRum.site") || "datadoghq.com" %>',
+       service: 'backstage',
+       env: '<%= config.getString("app.datadogRum.env") %>',
+       sampleRate:
+         '<%= config.getOptionalNumber("app.datadogRum.sessionSampleRate") || 100 %>',
+       sessionReplaySampleRate:
+         '<%= config.getOptionalNumber("app.datadogRum.sessionReplaySampleRate") || 0 %>',
+       trackInteractions: true,
+     });
+   });
+ </script>
+ <% } %>
 ```

From 51bf5fa47d87b8ca76c5fa9469b1362c065bb8d0 Mon Sep 17 00:00:00 2001
From: Evan Kelly <Evan.Kelly@fmr.com>
Date: Tue, 2 Jul 2024 10:53:39 +0100
Subject: [PATCH 3/7] make change suggested in pr

Signed-off-by: Evan Kelly <Evan.Kelly@fmr.com>
---
 docs/integrations/datadog-rum/installation.md | 24 ++++++++-----------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/docs/integrations/datadog-rum/installation.md b/docs/integrations/datadog-rum/installation.md
index 1301f111f7..f636b100a1 100644
--- a/docs/integrations/datadog-rum/installation.md
+++ b/docs/integrations/datadog-rum/installation.md
@@ -26,20 +26,7 @@ app:
   #   sessionReplaySampleRate: 0
 ```
 
-If your [`app-config.yaml`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/app-config.yaml#L5) file does not have this configuration, you may have to adjust your [`packages/app/public/index.html`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/packages/app/public/index.html#L69) to include the Datadog RUM `init()` section manually.
-
-The `clientToken` and `applicationId` are generated from the Datadog RUM page
-following
-[these instructions](https://docs.datadoghq.com/real_user_monitoring/browser/).
-
-There are two optional arguments:
-
-- `site`: The Datadog site of your organization; defaults to `datadoghq.com`
-- `env`: The application environment for Datadog events (no default)
-
-## Script to fix Datadog RUM not Publishing Issue
-
-Copy and paste this section to your `packages/app/public/index.html`
+If your [`app-config.yaml`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/app-config.yaml#L5) file does not have this configuration, you may have to adjust your [`packages/app/public/index.html`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/packages/app/public/index.html#L69) to include the Datadog RUM `init()` section manually. If you a Datadog not publishing issue copy and paste this section in to your `packages/app/public/index.html`
 
 ```
 <% if (config.has('app.datadogRum')) { %>
@@ -81,3 +68,12 @@ Copy and paste this section to your `packages/app/public/index.html`
  </script>
  <% } %>
 ```
+
+The `clientToken` and `applicationId` are generated from the Datadog RUM page
+following
+[these instructions](https://docs.datadoghq.com/real_user_monitoring/browser/).
+
+There are two optional arguments:
+
+- `site`: The Datadog site of your organization; defaults to `datadoghq.com`
+- `env`: The application environment for Datadog events (no default)

From 100ecdcb947e18d015ce26312da55c48b9196f53 Mon Sep 17 00:00:00 2001
From: Evan Kelly <Evan.Kelly@fmr.com>
Date: Wed, 10 Jul 2024 08:07:38 +0100
Subject: [PATCH 4/7] changes for comments on pr

Signed-off-by: Evan Kelly <Evan.Kelly@fmr.com>
---
 docs/integrations/datadog-rum/installation.md | 80 ++++++++++---------
 1 file changed, 41 insertions(+), 39 deletions(-)

diff --git a/docs/integrations/datadog-rum/installation.md b/docs/integrations/datadog-rum/installation.md
index f636b100a1..5afd05d6cb 100644
--- a/docs/integrations/datadog-rum/installation.md
+++ b/docs/integrations/datadog-rum/installation.md
@@ -26,47 +26,49 @@ app:
   #   sessionReplaySampleRate: 0
 ```
 
-If your [`app-config.yaml`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/app-config.yaml#L5) file does not have this configuration, you may have to adjust your [`packages/app/public/index.html`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/packages/app/public/index.html#L69) to include the Datadog RUM `init()` section manually. If you a Datadog not publishing issue copy and paste this section in to your `packages/app/public/index.html`
+If your [`app-config.yaml`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/app-config.yaml#L5) file does not have this configuration, you may have to adjust your [`packages/app/public/index.html`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/packages/app/public/index.html#L69) to include the Datadog RUM `init()` section manually.
 
-```
+:::note
+In case after a proper configuration, the events still arent being capture copy and paste this section in to your `packages/app/public/index.html` under the `<head>` tag.
+
+```html
 <% if (config.has('app.datadogRum')) { %>
- <script>
-   (function (h, o, u, n, d) {
-     h = h[d] = h[d] || {
-       q: [],
-       onReady: function (c) {
-         h.q.push(c);
-       },
-     };
-     d = o.createElement(u);
-     d.async = 1;
-     d.src = n;
-     n = o.getElementsByTagName(u)[0];
-     n.parentNode.insertBefore(d, n);
-   })(
-     window,
-     document,
-     'script',
-     'https://www.datadoghq-browser-agent.com/datadog-rum-v3.js',
-     'DD_RUM',
-   );
-   DD_RUM.onReady(function () {
-     DD_RUM.init({
-       clientToken: '<%= config.getString("app.datadogRum.clientToken") %>',
-       applicationId:
-         '<%= config.getString("app.datadogRum.applicationId") %>',
-       site: '<%= config.getOptionalString("app.datadogRum.site") || "datadoghq.com" %>',
-       service: 'backstage',
-       env: '<%= config.getString("app.datadogRum.env") %>',
-       sampleRate:
-         '<%= config.getOptionalNumber("app.datadogRum.sessionSampleRate") || 100 %>',
-       sessionReplaySampleRate:
-         '<%= config.getOptionalNumber("app.datadogRum.sessionReplaySampleRate") || 0 %>',
-       trackInteractions: true,
-     });
-   });
- </script>
- <% } %>
+<script>
+  (function (h, o, u, n, d) {
+    h = h[d] = h[d] || {
+      q: [],
+      onReady: function (c) {
+        h.q.push(c);
+      },
+    };
+    d = o.createElement(u);
+    d.async = 1;
+    d.src = n;
+    n = o.getElementsByTagName(u)[0];
+    n.parentNode.insertBefore(d, n);
+  })(
+    window,
+    document,
+    'script',
+    'https://www.datadoghq-browser-agent.com/datadog-rum-v3.js',
+    'DD_RUM',
+  );
+  DD_RUM.onReady(function () {
+    DD_RUM.init({
+      clientToken: '<%= config.getString("app.datadogRum.clientToken") %>',
+      applicationId: '<%= config.getString("app.datadogRum.applicationId") %>',
+      site: '<%= config.getOptionalString("app.datadogRum.site") || "datadoghq.com" %>',
+      service: 'backstage',
+      env: '<%= config.getString("app.datadogRum.env") %>',
+      sampleRate:
+        '<%= config.getOptionalNumber("app.datadogRum.sessionSampleRate") || 100 %>',
+      sessionReplaySampleRate:
+        '<%= config.getOptionalNumber("app.datadogRum.sessionReplaySampleRate") || 0 %>',
+      trackInteractions: true,
+    });
+  });
+</script>
+<% } %>
 ```
 
 The `clientToken` and `applicationId` are generated from the Datadog RUM page

From 3f88be264f8fe1027a438d96772fdbb987b84b54 Mon Sep 17 00:00:00 2001
From: "Kelly, Evan" <Evan.Kelly@fmr.com>
Date: Fri, 12 Jul 2024 09:31:01 +0100
Subject: [PATCH 5/7] Update installation.md

Signed-off-by: Kelly, Evan <Evan.Kelly@fmr.com>
Signed-off-by: Evan Kelly <Evan.Kelly@fmr.com>
---
 docs/integrations/datadog-rum/installation.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/integrations/datadog-rum/installation.md b/docs/integrations/datadog-rum/installation.md
index 5afd05d6cb..414317d593 100644
--- a/docs/integrations/datadog-rum/installation.md
+++ b/docs/integrations/datadog-rum/installation.md
@@ -28,6 +28,8 @@ app:
 
 If your [`app-config.yaml`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/app-config.yaml#L5) file does not have this configuration, you may have to adjust your [`packages/app/public/index.html`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/packages/app/public/index.html#L69) to include the Datadog RUM `init()` section manually.
 
+Please note, there's a bug where env value MUST be specified at build time
+
 :::note
 In case after a proper configuration, the events still arent being capture copy and paste this section in to your `packages/app/public/index.html` under the `<head>` tag.
 

From 3fbf4a8719270ed227f8496ec0edeebca7abd271 Mon Sep 17 00:00:00 2001
From: Evan Kelly <47178446+EvanGKelly@users.noreply.github.com>
Date: Wed, 7 Aug 2024 11:13:29 +0100
Subject: [PATCH 6/7] Update docs/integrations/datadog-rum/installation.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Signed-off-by: Evan Kelly <47178446+EvanGKelly@users.noreply.github.com>
---
 docs/integrations/datadog-rum/installation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/integrations/datadog-rum/installation.md b/docs/integrations/datadog-rum/installation.md
index 414317d593..8213b8296f 100644
--- a/docs/integrations/datadog-rum/installation.md
+++ b/docs/integrations/datadog-rum/installation.md
@@ -28,7 +28,7 @@ app:
 
 If your [`app-config.yaml`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/app-config.yaml#L5) file does not have this configuration, you may have to adjust your [`packages/app/public/index.html`](https://github.com/backstage/backstage/blob/e0506af8fc54074a160fb91c83d6cae8172d3bb3/packages/app/public/index.html#L69) to include the Datadog RUM `init()` section manually.
 
-Please note, there's a bug where env value MUST be specified at build time
+Please note that the env value MUST be specified at build time
 
 :::note
 In case after a proper configuration, the events still arent being capture copy and paste this section in to your `packages/app/public/index.html` under the `<head>` tag.

From 807bd071759be7e431d09c300839177498850bc9 Mon Sep 17 00:00:00 2001
From: Evan Kelly <47178446+EvanGKelly@users.noreply.github.com>
Date: Wed, 7 Aug 2024 11:13:39 +0100
Subject: [PATCH 7/7] Update docs/integrations/datadog-rum/installation.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Signed-off-by: Evan Kelly <47178446+EvanGKelly@users.noreply.github.com>
---
 docs/integrations/datadog-rum/installation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/integrations/datadog-rum/installation.md b/docs/integrations/datadog-rum/installation.md
index 8213b8296f..6659bec182 100644
--- a/docs/integrations/datadog-rum/installation.md
+++ b/docs/integrations/datadog-rum/installation.md
@@ -31,7 +31,7 @@ If your [`app-config.yaml`](https://github.com/backstage/backstage/blob/e0506af8
 Please note that the env value MUST be specified at build time
 
 :::note
-In case after a proper configuration, the events still arent being capture copy and paste this section in to your `packages/app/public/index.html` under the `<head>` tag.
+In case after a proper configuration, the events still are not being captured: Copy and paste this section in to your `packages/app/public/index.html` under the `<head>` tag.
 
 ```html
 <% if (config.has('app.datadogRum')) { %>