From bdb142f74622cb476a72c43d6c2f997bb00973f1 Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Mon, 17 Mar 2025 10:11:10 +0100 Subject: [PATCH] docs: Warn about risks of `reactComponentAnnotation` --- packages/dev-utils/src/generate-documentation-table.ts | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/packages/dev-utils/src/generate-documentation-table.ts b/packages/dev-utils/src/generate-documentation-table.ts index bd522fe7..197673a2 100644 --- a/packages/dev-utils/src/generate-documentation-table.ts +++ b/packages/dev-utils/src/generate-documentation-table.ts @@ -377,12 +377,8 @@ type IncludeEntry = { }, { name: "reactComponentAnnotation", - fullDescription: `Options related to react component name annotations. - Disabled by default, unless a value is set for this option. - When enabled, your app's DOM will automatically be annotated during build-time with their respective component names. - This will unlock the capability to search for Replays in Sentry by component name, as well as see component names in breadcrumbs and performance monitoring. - Please note that this feature is not currently supported by the esbuild bundler plugins, and will only annotate React components - `, + fullDescription: `(NOTICE: Use the react component annotation feature with caution. The option will pass additional properties to your React components which may lead to errors if libraries or your own code iterate through component props without checking for the additional Sentry props.)\n\nOptions related to react component name annotations. + Disabled by default, unless a value is set for this option.\nWhen enabled, your app's DOM will automatically be annotated during build-time with their respective component names.\nThis will unlock the capability to search for Replays in Sentry by component name, as well as see component names in breadcrumbs and performance monitoring.`, supportedBundlers: ["webpack", "vite", "rollup"], children: [ {