update docs

Author: kyledurand

polaris-react/src/components/Popover/Popover.tsx

@@ -33,7 +33,10 @@ export interface PopoverProps {
   preferredAlignment?: PopoverOverlayProps['preferredAlignment'];
   /** Show or hide the Popover */
   active: boolean;
-  /** The element to activate the Popover */
+  /** The element to activate the Popover.
+   * If using a button, use the default or tertiary variant
+   * which will show an active state when popover is active
+   */
   activator: React.ReactElement;
   /**
    * Use the activator's input element to calculate the Popover position

polaris.shopify.com/content/components/overlays/popover.mdx

@@ -59,6 +59,7 @@ Popovers should:
 - Be used for secondary or less important information and actions since they’re hidden until merchants hit the trigger
 - Contain navigation or actions that share a relationships to each other
 - Be triggered by a clearly labeled button
+- Use a default or tertiary button as the activator
 
 ---