more clarification

Author: mydea

docs/platforms/javascript/common/apis.mdx

@@ -134,6 +134,8 @@ If you use a bundler, using e.g. `const { replayIntegration } = await import('@s
   Returns the current scope. See{" "}
   <PlatformLink to="/enriching-events/scopes/">Scopes</PlatformLink> for more
   information.
+
+  Note that in most cases you should not use this API, but instead use `withScope` to generate and access a local scope. There are no guarantees about the consistency of `getCurrentScope` across different parts of your application, as scope forking may happen under the hood at various points.
 </SdkApi>
 
 <SdkApi

docs/platforms/javascript/common/enriching-events/scopes/index.mdx

@@ -77,7 +77,7 @@ Sentry.withScope((scope) => {
 Sentry.captureException(new Error("my other error"));
 ```
 
-You can access the current scope via `Sentry.getCurrentScope()`, but usually you should use `Sentry.withScope()` to interact with local scopes instead.
+You can access the current scope via `Sentry.getCurrentScope()`, but in most cases you should not use this API, but instead use `withScope` to generate and access a local scope. There are no guarantees about the consistency of `getCurrentScope` across different parts of your application, as scope forking may happen under the hood at various points.
 
 ## How Scope Data is Applied to Events