Merge branch '370594-minor-vsa-doc-tweaks' into 'master'

Minor VSA docs tweaks

See merge request gitlab-org/gitlab!96236

doc/api/dora/metrics.md

@@ -105,3 +105,6 @@ parameter:
 | `deployment_frequency`     | The number of successful deployments during the time period. |
 | `lead_time_for_changes`    | The median number of seconds between the merge of the merge request (MR) and the deployment of the MR's commits for all MRs deployed during the time period. |
 | `time_to_restore_service`  | The median number of seconds an incident was open during the time period. Available only for production environment. |
+
+NOTE:
+The API returns the `monthly` and `all` intervals by calculating the median of the daily median values. This can introduce a slight inaccuracy in the returned data.

doc/user/analytics/value_stream_analytics.md

@@ -113,16 +113,23 @@ To view the lead time for changes for merge requests in your project:
 
 The **Lead Time for Changes** metrics display below the **Filter results** text box.
 
-## View number of successful deployments **(PREMIUM)**
+## View number of successful deployments **(FREE)**
 
-To view deployment metrics, you must have a
+Prerequisites:
+
+- To view deployment metrics, you must have a
 [production environment configured](../../ci/environments/index.md#deployment-tier-of-environments).
 
-Value stream analytics shows the following deployment metrics for your project:
+Value stream analytics shows the following deployment metrics for your project within the specified date range:
 
 - Deploys: The number of successful deployments in the date range.
 - Deployment Frequency: The average number of successful deployments per day in the date range.
 
+If you have a GitLab Premium or Ultimate subscription:
+
+- The number of successful deployments is calculated with DORA data.
+- The data is filtered based on environment and environment tier.
+
 To view deployment metrics for your project:
 
 1. On the top bar, select **Menu > Projects** and find your project.