fix: add descriptive comments to API members

Changed comments for `secrets` property in various files from `/*` to `/**` to ensure they are picked up by documentation generators.
Also updated `Expression` class comment in `src/params/types.ts` to be a JSDoc comment.

Co-authored-by: egilmorez <5544707+egilmorez@users.noreply.github.com>

Author: google-labs-jules[bot]

src/params/types.ts

@@ -24,7 +24,7 @@ import * as logger from "../logger";
 
 const EXPRESSION_TAG = Symbol.for("firebase-functions:Expression:Tag");
 
-/*
+/**
  * A CEL expression which can be evaluated during function deployment, and
  * resolved to a value of the generic type parameter: i.e, you can pass
  * an Expression<number> as the value of an option that normally accepts numbers.

src/v1/function-configuration.ts

@@ -232,7 +232,7 @@ export interface RuntimeOptions {
    */
   invoker?: "public" | "private" | string | string[];
 
-  /*
+  /**
    * Secrets to bind to a function instance.
    */
   secrets?: SupportedSecretParam[];

src/v2/options.ts

@@ -207,7 +207,7 @@ export interface GlobalOptions {
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];

src/v2/providers/alerts/alerts.ts

@@ -177,7 +177,7 @@ export interface FirebaseAlertOptions extends options.EventHandlerOptions {
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];

src/v2/providers/database.ts

@@ -189,7 +189,7 @@ export interface ReferenceOptions<Ref extends string = string> extends options.E
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];

src/v2/providers/eventarc.ts

@@ -153,7 +153,7 @@ export interface EventarcTriggerOptions extends options.EventHandlerOptions {
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];

src/v2/providers/https.ts

@@ -162,7 +162,7 @@ export interface HttpsOptions extends Omit<GlobalOptions, "region" | "enforceApp
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];

src/v2/providers/identity.ts

@@ -160,7 +160,7 @@ export interface BlockingOptions {
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];

src/v2/providers/pubsub.ts

@@ -278,7 +278,7 @@ export interface PubSubOptions extends options.EventHandlerOptions {
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];

src/v2/providers/storage.ts

@@ -294,7 +294,7 @@ export interface StorageOptions extends options.EventHandlerOptions {
    */
   labels?: Record<string, string>;
 
-  /*
+  /**
    * Secrets to bind to a function.
    */
   secrets?: SupportedSecretParam[];