Add jsdoc to angular FirebaseErrorHandler telemetry API (#9404)

* Add jsdoc to angular FirebaseErrorHandler telemetry API

* Add another example to block

* Add generated doc files

Author: tonybaroneee

common/api-review/telemetry-angular.api.md

@@ -8,7 +8,7 @@ import { ErrorHandler } from '@angular/core';
 import { FirebaseApp } from '@firebase/app';
 import { LoggerProvider } from '@opentelemetry/sdk-logs';
 
-// @public (undocumented)
+// @public
 export class FirebaseErrorHandler implements ErrorHandler {
     constructor(telemetryOptions?: TelemetryOptions | undefined);
     // (undocumented)

docs-devsite/telemetry_angular.firebaseerrorhandler.md

@@ -10,6 +10,10 @@ https://github.com/firebase/firebase-js-sdk
 {% endcomment %}
 
 # FirebaseErrorHandler class
+A custom ErrorHandler that captures uncaught errors and sends them to Firebase Telemetry.
+
+This should be provided in your application's root module.
+
 <b>Signature:</b>
 
 ```typescript
@@ -63,3 +67,44 @@ handleError(error: unknown): void;
 
 void
 
+### Example 1
+
+Basic usage:
+
+```typescript
+import { ErrorHandler } from '@angular/core';
+import { FirebaseErrorHandler } from '@firebase/telemetry-angular';
+
+@NgModule({
+  // ...
+  providers: [
+    { provide: ErrorHandler, useClass: FirebaseErrorHandler }
+  ],
+  // ...
+})
+export class AppModule { }
+
+```
+
+### Example 2
+
+Providing telemetry options:
+
+```typescript
+import { ErrorHandler } from '@angular/core';
+import { FirebaseErrorHandler } from '@firebase/telemetry-angular';
+
+@NgModule({
+  // ...
+  providers: [
+    {
+      provide: ErrorHandler,
+      useFactory: () => new FirebaseErrorHandler({ appVersion: '1.2.3' })
+    }
+  ],
+  // ...
+})
+export class AppModule { }
+
+```
+

docs-devsite/telemetry_angular.md

@@ -15,7 +15,7 @@ https://github.com/firebase/firebase-js-sdk
 
 |  Class | Description |
 |  --- | --- |
-|  [FirebaseErrorHandler](./telemetry_angular.firebaseerrorhandler.md#firebaseerrorhandler_class) |  |
+|  [FirebaseErrorHandler](./telemetry_angular.firebaseerrorhandler.md#firebaseerrorhandler_class) | A custom ErrorHandler that captures uncaught errors and sends them to Firebase Telemetry.<!-- -->This should be provided in your application's root module. |
 
 ## Interfaces
 

packages/telemetry/src/angular/index.ts

@@ -28,6 +28,51 @@ registerTelemetry();
 
 export * from '../public-types';
 
+/**
+ * A custom ErrorHandler that captures uncaught errors and sends them to Firebase Telemetry.
+ *
+ * This should be provided in your application's root module.
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * import { ErrorHandler } from '@angular/core';
+ * import { FirebaseErrorHandler } from '@firebase/telemetry-angular';
+ *
+ * @NgModule({
+ *   // ...
+ *   providers: [
+ *     { provide: ErrorHandler, useClass: FirebaseErrorHandler }
+ *   ],
+ *   // ...
+ * })
+ * export class AppModule { }
+ * ```
+ *
+ * @example
+ * Providing telemetry options:
+ * ```typescript
+ * import { ErrorHandler } from '@angular/core';
+ * import { FirebaseErrorHandler } from '@firebase/telemetry-angular';
+ *
+ * @NgModule({
+ *   // ...
+ *   providers: [
+ *     {
+ *       provide: ErrorHandler,
+ *       useFactory: () => new FirebaseErrorHandler({ appVersion: '1.2.3' })
+ *     }
+ *   ],
+ *   // ...
+ * })
+ * export class AppModule { }
+ * ```
+ *
+ * @param telemetryOptions - Optional. {@link TelemetryOptions} that configure the Telemetry instance.
+ * To provide these options, you must use a `useFactory` provider as shown in the example above.
+ *
+ * @public
+ */
 export class FirebaseErrorHandler implements ErrorHandler {
   private readonly router = inject(Router);