[Cosmos] TSDoc compliance (Azure#13849)

Author: zfoster

sdk/cosmosdb/cosmos/consumer-test.js

@@ -1,6 +1,6 @@
 const execa = require("execa");
 
-let versions = ["3.1", "3.9"];
+let versions = ["3.9"];
 
 if (!process.env.SKIP_LATEST) {
   versions.push("latest");
@@ -17,11 +17,11 @@ async function exec(cmd) {
   try {
     console.log("Running typescript consumer test against", versions);
     for (const version of versions) {
-      console.log(`Compling with typescript@${version} - Basic`);
+      console.log(`Compiling with typescript@${version} - Basic`);
       await exec(
         `npx -p typescript@${version} tsc ./test.ts --allowSyntheticDefaultImports true --target ES5`
       );
-      console.log(`Compling with typescript@${version} - Custom lib`);
+      console.log(`Compiling with typescript@${version} - Custom lib`);
       await exec(
         `npx -p typescript@${version} tsc ./test.ts --allowSyntheticDefaultImports true --lib es2018`
       );

sdk/cosmosdb/cosmos/review/cosmos.api.md

@@ -723,7 +723,6 @@ export class GlobalEndpointManager {
     constructor(options: CosmosClientOptions, readDatabaseAccount: (opts: RequestOptions) => Promise<ResourceResponse<DatabaseAccount>>);
     // (undocumented)
     canUseMultipleWriteLocations(resourceType?: ResourceType, operationType?: OperationType): boolean;
-    // (undocumented)
     enableEndpointDiscovery: boolean;
     getReadEndpoint(): Promise<string>;
     // (undocumented)

sdk/cosmosdb/cosmos/src/ChangeFeedIterator.ts

@@ -23,13 +23,6 @@ export class ChangeFeedIterator<T> {
 
   /**
    * @internal
-   * @hidden
-   *
-   * @param clientContext
-   * @param resourceId
-   * @param resourceLink
-   * @param isPartitionedContainer
-   * @param changeFeedOptions
    */
   constructor(
     private clientContext: ClientContext,

sdk/cosmosdb/cosmos/src/ChangeFeedResponse.ts

@@ -9,12 +9,6 @@ import { CosmosHeaders } from "./queryExecutionContext";
 export class ChangeFeedResponse<T> {
   /**
    * @internal
-   * @hidden
-   *
-   * @param result
-   * @param count
-   * @param statusCode
-   * @param headers
    */
   constructor(
     /**

sdk/cosmosdb/cosmos/src/ClientContext.ts

@@ -505,7 +505,7 @@ export class ClientContext {
 
   /**
    * Gets the Database account information.
-   * @param {string} [options.urlConnection]   - The endpoint url whose database account needs to be retrieved. \
+   * @param options - `urlConnection` in the options is the endpoint url whose database account needs to be retrieved.
    * If not present, current client's url will be used.
    */
   public async getDatabaseAccount(

sdk/cosmosdb/cosmos/src/CosmosClient.ts

@@ -56,7 +56,7 @@ export class CosmosClient {
   constructor(connectionString: string);
   /**
    * Creates a new {@link CosmosClient} object. See {@link CosmosClientOptions} for more details on what options you can use.
-   * @param options bag of options - require at least endpoint and auth to be configured
+   * @param options - bag of options; require at least endpoint and auth to be configured
    */
   constructor(options: CosmosClientOptions); // tslint:disable-line:unified-signatures
   constructor(optionsOrConnectionString: string | CosmosClientOptions) {
@@ -131,7 +131,7 @@ export class CosmosClient {
    *
    * This does not make a network call. Use `.read` to get info about the database after getting the {@link Database} object.
    *
-   * @param id The id of the database.
+   * @param id - The id of the database.
    * @example Create a new container off of an existing database
    * ```typescript
    * const container = client.database("<database id>").containers.create("<container id>");
@@ -148,7 +148,7 @@ export class CosmosClient {
 
   /**
    * Used for reading, or updating a existing offer by id.
-   * @param id The id of the offer.
+   * @param id - The id of the offer.
    */
   public offer(id: string) {
     return new Offer(this, id, this.clientContext);

sdk/cosmosdb/cosmos/src/CosmosClientOptions.ts

@@ -29,8 +29,8 @@ export interface CosmosClientOptions {
    * Allows users to generating their own auth tokens, potentially using a separate service
    */
   tokenProvider?: TokenProvider;
-  /** AAD token from @azure/identity
-   * Obtain a credential object by creating an @azure/identity credential object
+  /** AAD token from `@azure/identity`
+   * Obtain a credential object by creating an `@azure/identity` credential object
    * We will then use your credential object and a scope URL (your cosmos db endpoint)
    * to authenticate requests to Cosmos
    * This feature is in private preview and not yet available for every Cosmos account

sdk/cosmosdb/cosmos/src/auth.ts

@@ -24,12 +24,6 @@ export type TokenProvider = (requestInfo: RequestInfo) => Promise<string>;
 
 /**
  * @hidden
- * @param clientOptions
- * @param verb
- * @param path
- * @param resourceId
- * @param resourceType
- * @param headers
  */
 export async function setAuthorizationHeader(
   clientOptions: CosmosClientOptions,
@@ -102,9 +96,6 @@ export async function setAuthorizationTokenHeaderUsingMasterKey(
 
 /**
  * @hidden
- * @param resourceTokens
- * @param path
- * @param resourceId
  */
 // TODO: Resource tokens
 export function getAuthorizationTokenUsingResourceTokens(

sdk/cosmosdb/cosmos/src/client/Conflict/Conflict.ts

@@ -21,8 +21,8 @@ export class Conflict {
   }
   /**
    * @hidden
-   * @param container The parent {@link Container}.
-   * @param id The id of the given {@link Conflict}.
+   * @param container - The parent {@link Container}.
+   * @param id - The id of the given {@link Conflict}.
    */
   constructor(
     public readonly container: Container,
@@ -32,7 +32,6 @@ export class Conflict {
 
   /**
    * Read the {@link ConflictDefinition} for the given {@link Conflict}.
-   * @param options
    */
   public async read(options?: RequestOptions): Promise<ConflictResponse> {
     const path = getPathFromLink(this.url, ResourceType.conflicts);
@@ -49,7 +48,6 @@ export class Conflict {
 
   /**
    * Delete the given {@link ConflictDefinition}.
-   * @param options
    */
   public async delete(options?: RequestOptions): Promise<ConflictResponse> {
     const path = getPathFromLink(this.url);

sdk/cosmosdb/cosmos/src/client/Conflict/Conflicts.ts

@@ -22,15 +22,15 @@ export class Conflicts {
 
   /**
    * Queries all conflicts.
-   * @param query Query configuration for the operation. See {@link SqlQuerySpec} for more info on how to configure a query.
-   * @param options Use to set options like response page size, continuation tokens, etc.
+   * @param query - Query configuration for the operation. See {@link SqlQuerySpec} for more info on how to configure a query.
+   * @param options - Use to set options like response page size, continuation tokens, etc.
    * @returns {@link QueryIterator} Allows you to return results in an array or iterate over them one at a time.
    */
   public query(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<any>;
   /**
    * Queries all conflicts.
-   * @param query Query configuration for the operation. See {@link SqlQuerySpec} for more info on how to configure a query.
-   * @param options Use to set options like response page size, continuation tokens, etc.
+   * @param query - Query configuration for the operation. See {@link SqlQuerySpec} for more info on how to configure a query.
+   * @param options - Use to set options like response page size, continuation tokens, etc.
    * @returns {@link QueryIterator} Allows you to return results in an array or iterate over them one at a time.
    */
   public query<T>(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<T>;
@@ -52,7 +52,7 @@ export class Conflicts {
 
   /**
    * Reads all conflicts
-   * @param options Use to set options like response page size, continuation tokens, etc.
+   * @param options - Use to set options like response page size, continuation tokens, etc.
    */
   public readAll(options?: FeedOptions): QueryIterator<ConflictDefinition & Resource> {
     return this.query<ConflictDefinition & Resource>(undefined, options);