add docs

Author: silesky

packages/browser/src/core/analytics/index.ts

@@ -256,6 +256,24 @@ export class Analytics
     })
   }
 
+  /**
+   *
+   * @param args - `[category], [name], [properties], [options], [callback]`
+   * @example
+   * ```ts
+   *  analytics.page('My Category', 'Pricing', {
+   *    title: 'My Overridden Title',
+   *    myExtraProp: 'foo'
+   *  })
+   *
+   *  analytics.page('Pricing', {
+   *    title: 'My Overridden Title',
+   *    myExtraProp: 'foo'
+   *  });
+   *
+   * ```
+   * @link https://segment.com/docs/connections/sources/catalog/libraries/website/javascript/#page
+   */
   async page(...args: PageParams): Promise<DispatchedEvent> {
     const pageCtx = popPageContext(args)
     const [category, page, properties, options, callback] =

packages/browser/src/core/buffer/index.ts

@@ -354,6 +354,24 @@ export class AnalyticsBuffered
   ready = this._createMethod('ready')
   alias = this._createMethod('alias')
   debug = this._createChainableMethod('debug')
+  /**
+   *
+   * @param args - `[category], [name], [properties], [options], [callback]`
+   * @example
+   * ```ts
+   *  analytics.page('My Category', 'Pricing', {
+   *    title: 'My Overridden Title',
+   *    myExtraProp: 'foo'
+   *  })
+   *
+   *  analytics.page('Pricing', {
+   *    title: 'My Overridden Title',
+   *    myExtraProp: 'foo'
+   *  });
+   *
+   * ```
+   * @link https://segment.com/docs/connections/sources/catalog/libraries/website/javascript/#page
+   */
   page = this._createMethod('page')
   once = this._createChainableMethod('once')
   off = this._createChainableMethod('off')