docs(): usage and examples

core/src/components/popover-controller/popover-controller.tsx

@@ -27,7 +27,7 @@ export class PopoverController implements OverlayController {
     removeLastOverlay(this.popovers);
   }
 
-  /*
+  /**
    * Create a popover overlay with popover options.
    */
   @Method()
@@ -35,7 +35,7 @@ export class PopoverController implements OverlayController {
     return createOverlay(this.doc.createElement('ion-popover'), opts);
   }
 
-  /*
+  /**
    * Dismiss the open popover overlay.
    */
   @Method()
@@ -43,7 +43,7 @@ export class PopoverController implements OverlayController {
     return dismissOverlay(data, role, this.popovers, popoverId);
   }
 
-  /*
+  /**
    * Get the most recently opened popover overlay.
    */
   @Method()

core/src/components/popover-controller/readme.md

@@ -2,18 +2,6 @@
 
 Popover controllers programmatically control the popover component. Popovers can be created and dismissed from the popover controller. View the [Popover](../../popover/Popover) documentation for a full list of options to pass upon creation.
 
-```javascript
-async function presentPopover() {
-  const popoverController = document.querySelector('ion-popover-controller');
-  await popoverController.componentOnReady();
-
-  const popoverElement = await popoverController.create({
-    component: 'profile-page',
-    ev: event
-  });
-  return await popoverElement.present();
-}
-```
 
 <!-- Auto Generated Below -->
 

core/src/components/popover-controller/usage/javascript.md

@@ -0,0 +1,12 @@
+```javascript
+async function presentPopover() {
+  const popoverController = document.querySelector('ion-popover-controller');
+  await popoverController.componentOnReady();
+
+  const popoverElement = await popoverController.create({
+    component: 'profile-page',
+    ev: event
+  });
+  return await popoverElement.present();
+}
+```