Merge pull request #5398 from backstage/timbonicus/rum-docs

Datadog RUM minor doc cleanup

docs/integrations/datadog-rum/installation.md

@@ -3,28 +3,32 @@ id: installation
 title: Datadog RUM Installation
 sidebar_label: Installation
 # prettier-ignore
-description: Adding Datadog RUM to Your App
+description: Adding Datadog Real User Monitoring (RUM) to Your App
 ---
 
-There is a basic [Datadog](https://docs.datadoghq.com/real_user_monitoring/)
+Datadog Real User Monitoring (RUM) allows you to visualize and analyze the
+real-time performance and user journeys of your application's individual users.
+This is an option to profile and monitor the user experience of your Backstage
+installation.
+
+There is a basic [Datadog RUM](https://docs.datadoghq.com/real_user_monitoring/)
 integration built into Backstage. You can enable it by adding the following to
-your app configuration:
+your `app-config.yaml`:
 
 ```yaml
 app:
   datadogRum:
     clientToken: '123456789'
     applicationId: qwerty
-  #   site: # datadoghq.eu default = datadoghq.com
-  #   env: # optional
+  #   site: datadoghq.eu
+  #   env: 'staging'
 ```
 
-Replace the clientToken and applicationId with the ones generated for you
-Datadog.
+The `clientToken` and `applicationId` are generated from the Datadog RUM page
+following
+[these instructions](https://docs.datadoghq.com/real_user_monitoring/browser/).
 
-optional arguments:
+There are two optional arguments:
 
-```
-site: datadoghq.eu # default equals datadoghq.com
-env: dev # allow to specify the environment
-```
+- `site`: The Datadog site of your organization; defaults to `datadoghq.com`
+- `env`: The application environment for Datadog events (no default)

microsite/sidebars.json

@@ -109,6 +109,11 @@
           "integrations/bitbucket/discovery"
         ]
       },
+      {
+        "type": "subcategory",
+        "label": "Datadog",
+        "ids": ["integrations/datadog-rum/installation"]
+      },
       {
         "type": "subcategory",
         "label": "GitHub",