chore(cloud-rad): Add code fencing (#743)

Code examples need code fencing around them to distingish from
rich text for TSDoc.

Internally b/179483748

Script used:
https://github.com/fhinkel/cloud-rad-script/blob/main/fixExampleComments.js

packages/google-cloud-translate/src/index.ts

@@ -29,28 +29,35 @@ import * as v2 from './v2';
  * @module {constructor} @google-cloud/translate
  * @alias nodejs-translate
  *
- * @example <caption>Install the v3 client library with <a
- * href="https://www.npmjs.com/">npm</a>:</caption>
+ * @example Install the v3 client library with <a href="https://www.npmjs.com/">npm</a>:
+ * ```
  * npm install --save @google-cloud/translate
  *
- * @example <caption>Import the v3 client library:</caption>
+ * ```
+ * @example Import the v3 client library:
+ * ```
  * const {TranslationServiceClient} = require('@google-cloud/translate');
  *
- * @example <caption>Create a v3 client that uses <a
- * href="https://goo.gl/64dyYX">Application Default Credentials
- * (ADC)</a>:</caption>
+ * ```
+ * @example Create a v3 client that uses <a href="https://goo.gl/64dyYX">Application Default Credentials (ADC)</a>:
+ * ```
  * const client = new TranslationServiceClient();
  *
+ * ```
  * @example <caption>include:samples/quickstart.js</caption>
  * region_tag:translate_quickstart
  * Full quickstart example:
  *
- * @example <caption>Install the v3beta1 client library:</caption>
+ * @example Install the v3beta1 client library:
+ * ```
  * npm install --save @google-cloud/translate
  *
- * @example <caption>Import the v3beta1 client library:</caption>
+ * ```
+ * @example Import the v3beta1 client library:
+ * ```
  * const {TranslationServiceClient} =
  * require('@google-cloud/translate').v3beta1;
+ * ```
  */
 import * as v3beta1 from './v3beta1';
 import * as v3 from './v3';

packages/google-cloud-translate/src/v2/index.ts

@@ -118,13 +118,15 @@ export interface TranslateConfig extends GoogleAuthOptions {
  * @param {ClientConfig} [options] Configuration options.
  *
  * @example
+ * ```
  * //-
  * // <h3>Custom Translation API</h3>
  * //
  * // The environment variable, `GOOGLE_CLOUD_TRANSLATE_ENDPOINT`, is honored as
  * // a custom backend which our library will send requests to.
  * //-
  *
+ * ```
  * @example <caption>include:samples/quickstart.js</caption>
  * region_tag:translate_quickstart
  * Full quickstart example:
@@ -188,6 +190,7 @@ export class Translate extends Service {
    * @returns {Promise<DetectResponse>}
    *
    * @example
+   * ```
    * const {Translate} = require('@google-cloud/translate');
    *
    * const translate = new Translate();
@@ -237,6 +240,7 @@ export class Translate extends Service {
    *   const apiResponse = data[2];
    * });
    *
+   * ```
    * @example <caption>include:samples/translate.js</caption>
    * region_tag:translate_detect_language
    * Here's a full example:
@@ -439,6 +443,7 @@ export class Translate extends Service {
    * @returns {Promise<TranslateResponse>}
    *
    * @example
+   * ```
    * //-
    * // Pass a string and a language code to get the translation.
    * //-
@@ -489,6 +494,7 @@ export class Translate extends Service {
    *   const apiResponse = data[1];
    * });
    *
+   * ```
    * @example <caption>include:samples/translate.js</caption>
    * region_tag:translate_translate_text
    * Full translation example:

packages/google-cloud-translate/src/v3/translation_service_client.ts

@@ -504,7 +504,9 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [response] = await client.translateText(request);
+   * ```
    */
   translateText(
     request?: protos.google.cloud.translation.v3.ITranslateTextRequest,
@@ -630,7 +632,9 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [response] = await client.detectLanguage(request);
+   * ```
    */
   detectLanguage(
     request?: protos.google.cloud.translation.v3.IDetectLanguageRequest,
@@ -754,7 +758,9 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [response] = await client.getSupportedLanguages(request);
+   * ```
    */
   getSupportedLanguages(
     request?: protos.google.cloud.translation.v3.IGetSupportedLanguagesRequest,
@@ -905,7 +911,9 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [response] = await client.translateDocument(request);
+   * ```
    */
   translateDocument(
     request?: protos.google.cloud.translation.v3.ITranslateDocumentRequest,
@@ -993,7 +1001,9 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [response] = await client.getGlossary(request);
+   * ```
    */
   getGlossary(
     request?: protos.google.cloud.translation.v3.IGetGlossaryRequest,
@@ -1146,8 +1156,10 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [operation] = await client.batchTranslateText(request);
    * const [response] = await operation.promise();
+   * ```
    */
   batchTranslateText(
     request?: protos.google.cloud.translation.v3.IBatchTranslateTextRequest,
@@ -1207,10 +1219,12 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const decodedOperation = await checkBatchTranslateTextProgress(name);
    * console.log(decodedOperation.result);
    * console.log(decodedOperation.done);
    * console.log(decodedOperation.metadata);
+   * ```
    */
   async checkBatchTranslateTextProgress(
     name: string
@@ -1346,8 +1360,10 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [operation] = await client.batchTranslateDocument(request);
    * const [response] = await operation.promise();
+   * ```
    */
   batchTranslateDocument(
     request?: protos.google.cloud.translation.v3.IBatchTranslateDocumentRequest,
@@ -1411,10 +1427,12 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const decodedOperation = await checkBatchTranslateDocumentProgress(name);
    * console.log(decodedOperation.result);
    * console.log(decodedOperation.done);
    * console.log(decodedOperation.metadata);
+   * ```
    */
   async checkBatchTranslateDocumentProgress(
     name: string
@@ -1494,8 +1512,10 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [operation] = await client.createGlossary(request);
    * const [response] = await operation.promise();
+   * ```
    */
   createGlossary(
     request?: protos.google.cloud.translation.v3.ICreateGlossaryRequest,
@@ -1555,10 +1575,12 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const decodedOperation = await checkCreateGlossaryProgress(name);
    * console.log(decodedOperation.result);
    * console.log(decodedOperation.done);
    * console.log(decodedOperation.metadata);
+   * ```
    */
   async checkCreateGlossaryProgress(
     name: string
@@ -1637,8 +1659,10 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const [operation] = await client.deleteGlossary(request);
    * const [response] = await operation.promise();
+   * ```
    */
   deleteGlossary(
     request?: protos.google.cloud.translation.v3.IDeleteGlossaryRequest,
@@ -1698,10 +1722,12 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const decodedOperation = await checkDeleteGlossaryProgress(name);
    * console.log(decodedOperation.result);
    * console.log(decodedOperation.done);
    * console.log(decodedOperation.metadata);
+   * ```
    */
   async checkDeleteGlossaryProgress(
     name: string
@@ -1955,10 +1981,12 @@ export class TranslationServiceClient {
    *   {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination| documentation}
    *   for more details and examples.
    * @example
+   * ```
    * const iterable = client.listGlossariesAsync(request);
    * for await (const response of iterable) {
    *   // process response
    * }
+   * ```
    */
   listGlossariesAsync(
     request?: protos.google.cloud.translation.v3.IListGlossariesRequest,