Update comments

Signed-off-by: Johan Haals <johan.haals@gmail.com>

plugins/catalog-backend/api-report.md

@@ -419,19 +419,11 @@ export function createNextRouter(
   options: RouterOptions_2,
 ): Promise<express.Router>;
 
-// Warning: (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-// Warning: (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-// Warning: (tsdoc-param-tag-with-invalid-name) The @param block should be followed by a valid parameter name: The identifier cannot non-word characters
-// Warning: (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
-// Warning: (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-// Warning: (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-// Warning: (tsdoc-param-tag-with-invalid-name) The @param block should be followed by a valid parameter name: The identifier cannot non-word characters
-// Warning: (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
 // Warning: (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
 // Warning: (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
 // Warning: (ae-missing-release-tag) "createRandomRefreshInterval" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
 //
-// @public (undocumented)
+// @public
 export function createRandomRefreshInterval(options: {
   minSeconds: number;
   maxSeconds: number;

plugins/catalog-backend/src/next/NextCatalogBuilder.ts

@@ -165,8 +165,8 @@ export class NextCatalogBuilder {
   }
 
   /**
-   * Refresh spread configures configures the minimum and maximum number of seconds
-   * to wait between refreshes in addition to the configured refresh interval.
+   * Overwrites the default refresh interval function used to spread
+   * entity updates in the catalog.
    */
   setRefreshInterval(
     refreshInterval: RefreshIntervalFunction,

plugins/catalog-backend/src/next/refresh.ts

@@ -20,10 +20,8 @@
 export type RefreshIntervalFunction = () => number;
 
 /**
- * @param {number} options.minSeconds The minimum number of seconds between refreshes
- * @param {number} options.maxSeconds The maximum number of seconds between refreshes
+ * Creates a function that returns a random refresh interval between minSeconds and maxSeconds.
  * @returns {RefreshIntervalFunction} that provides the next refresh interval
- *
  */
 export function createRandomRefreshInterval(options: {
   minSeconds: number;