better docs

Author: mydea

packages/node-experimental/src/sdk/otelAsyncContextStrategy.ts

@@ -6,6 +6,7 @@ import { OTEL_CONTEXT_HUB_KEY } from './otelContextManager';
 
 /**
  * Sets the async context strategy to use follow the OTEL context under the hood.
+ * We handle forking a hub inside of our custom OTEL Context Manager (./otelContextManager.ts)
  */
 export function setOtelContextAsyncContextStrategy(): void {
   function getCurrentHub(): Hub | undefined {

packages/node-experimental/src/sdk/otelContextManager.ts

@@ -12,7 +12,13 @@ function createNewHub(parent: Hub | undefined): Hub {
   return getHubFromCarrier(carrier);
 }
 
-/** TODO docs */
+/**
+ * This is a custom ContextManager for OpenTelemetry, which extends the default AsyncLocalStorageContextManager.
+ * It ensures that we create a new hub per context, so that the OTEL Context & the Sentry Hub are always in sync.
+ *
+ * Note that we currently only support AsyncHooks with this,
+ * but since this should work for Node 14+ anyhow that should be good enough.
+ */
 export class SentryContextManager extends AsyncLocalStorageContextManager {
   /**
    * Overwrite with() of the original AsyncLocalStorageContextManager