diff --git a/CHANGELOG.md b/CHANGELOG.md
index e69de29bb..0df54b4ec 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1 @@
+- Fix reference docs for performance monitoring.
diff --git a/src/v2/providers/alerts/performance.ts b/src/v2/providers/alerts/performance.ts
index bc4ab22c9..ef0a5f5e0 100644
--- a/src/v2/providers/alerts/performance.ts
+++ b/src/v2/providers/alerts/performance.ts
@@ -38,27 +38,27 @@ import {
  * Payload is wrapped inside a {@link FirebaseAlertData} object.
  */
 export interface ThresholdAlertPayload {
-  /* Name of the trace or network request this alert is for (e.g. my_custom_trace, firebase.com/api/123) */
+  /** Name of the trace or network request this alert is for (e.g. my_custom_trace, firebase.com/api/123) */
   eventName: string;
-  /* The resource type this alert is for (i.e. trace, network request, screen rendering, etc.) */
+  /** The resource type this alert is for (i.e. trace, network request, screen rendering, etc.) */
   eventType: string;
-  /* The metric type this alert is for (i.e. success rate, response time, duration, etc.) */
+  /** The metric type this alert is for (i.e. success rate, response time, duration, etc.) */
   metricType: string;
-  /* The number of events checked for this alert condition */
+  /** The number of events checked for this alert condition */
   numSamples: number;
-  /* The threshold value of the alert condition without units (e.g. "75", "2.1") */
+  /** The threshold value of the alert condition without units (e.g. "75", "2.1") */
   thresholdValue: number;
-  /* The unit for the alert threshold (e.g. "percent", "seconds") */
+  /** The unit for the alert threshold (e.g. "percent", "seconds") */
   thresholdUnit: string;
-  /* The percentile of the alert condition, can be 0 if percentile is not applicable to the alert condition and omitted; range: [1, 100] */
+  /** The percentile of the alert condition, can be 0 if percentile is not applicable to the alert condition and omitted; range: [1, 100] */
   conditionPercentile?: number;
-  /* The app version this alert was triggered for, can be omitted if the alert is for a network request (because the alert was checked against data from all versions of app) or a web app (where the app is versionless) */
+  /** The app version this alert was triggered for, can be omitted if the alert is for a network request (because the alert was checked against data from all versions of app) or a web app (where the app is versionless) */
   appVersion?: string;
-  /* The value that violated the alert condition (e.g. "76.5", "3") */
+  /** The value that violated the alert condition (e.g. "76.5", "3") */
   violationValue: number;
-  /* The unit for the violation value (e.g. "percent", "seconds") */
+  /** The unit for the violation value (e.g. "percent", "seconds") */
   violationUnit: string;
-  /* The link to Fireconsole to investigate more into this alert */
+  /** The link to Fireconsole to investigate more into this alert */
   investigateUri: string;
 }
 
@@ -80,7 +80,7 @@ export const thresholdAlert = 'performance.threshold';
  * Configuration for app distribution functions.
  */
 export interface PerformanceOptions extends EventHandlerOptions {
-  // Scope the function to trigger on a specific application.
+  /** Scope the function to trigger on a specific application. */
   appId?: string;
 }