docs(Table): direct users to DataVis NITRO for most table use cases

src/components/Table/Table.stories.tsx

@@ -33,6 +33,12 @@ const meta: Meta<typeof Table> = {
   component: Table,
   parameters: {
     layout: 'centered',
+    docs: {
+      description: {
+        component:
+          '> 💡 **Prefer [DataVis NITRO](?path=/docs/components-text-data-display-datavis-nitro--docs) in most cases.** NITRO is designed to be simple out of the box while exposing power-user features for the click-curious — use `Table` only in lightweight situations where that overhead is genuinely unneeded.',
+      },
+    },
   },
   tags: ['autodocs'],
   argTypes: {

src/components/Table/Table.tsx

@@ -13,6 +13,10 @@ export interface TableProps extends React.TableHTMLAttributes<HTMLTableElement>
 /**
  * An accessible table component.
  *
+ * Prefer DataVis NITRO in most cases -- it is designed to be simple out of the box while
+ * exposing power-user features for click-curious users. Use `Table` only in lightweight
+ * situations where that overhead is genuinely unneeded.
+ *
  * @example
  * ```tsx
  * <Table>