chore(telemetry): add disclaimer to the doc; update new connection description COMPASS-8807 (#6653)

chore(telemetry): add disclaimer to the doc; update new connection description

Author: gribnoysup

packages/compass-telemetry/src/telemetry-events.ts

@@ -803,7 +803,9 @@ type NewConnectionEvent = ConnectionScopedEvent<{
     topology_type: string;
 
     /**
-     * The number of active connections.
+     * The number of saved active connections (doesn't include new connections
+     * that are not yet fully saved, like the ones created with the "New
+     * Connection" button)
      */
     num_active_connections: number;
 

scripts/generate-tracking-plan.ts

@@ -325,6 +325,12 @@ function generateMarkdownPlan(
   const markdown = `
 # Compass Tracking Plan
 
+> [!NOTE]
+> This plan represents the tracking plan for the current branch / commit that 
+> you have selected (\`main\` by default), it might not be released yet. To find
+> the tracking plan for the specific Compass version you can use the following
+> URL: https://github.com/mongodb-js/compass/blob/v<compass version>/docs/tracking-plan.md
+
 Generated on ${formattedDate}
 
 ## Table of Contents