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

* fix caption

* chore(cloud-rad): Add code fencing

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

* 🦉 Updates from OwlBot

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: fhinkel

src/entity.ts

@@ -55,9 +55,11 @@ export namespace entity {
    * @param {number} value The double value.
    *
    * @example
+   * ```
    * const {Datastore} = require('@google-cloud/datastore');
    * const datastore = new Datastore();
    * const aDouble = datastore.double(7.3);
+   * ```
    */
   export class Double {
     type: string;
@@ -119,9 +121,11 @@ export namespace entity {
    *     names to be converted using `integerTypeCastFunction`.
    *
    * @example
+   * ```
    * const {Datastore} = require('@google-cloud/datastore');
    * const datastore = new Datastore();
    * const anInt = datastore.int(7);
+   * ```
    */
   export class Int extends Number {
     type: string;
@@ -235,6 +239,7 @@ export namespace entity {
    * @param {number} coordinates.longitude Longitudinal value.
    *
    * @example
+   * ```
    * const {Datastore} = require('@google-cloud/datastore');
    * const datastore = new Datastore();
    * const coordinates = {
@@ -243,6 +248,7 @@ export namespace entity {
    * };
    *
    * const geoPoint = datastore.geoPoint(coordinates);
+   * ```
    */
   export class GeoPoint {
     value: Coordinates;
@@ -284,22 +290,27 @@ export namespace entity {
    * @param {string} [options.namespace] Optional namespace.
    *
    * @example
+   * ```
    * //-
    * // Create an incomplete key with a kind value of `Company`.
    * //-
    * const {Datastore} = require('@google-cloud/datastore');
    * const datastore = new Datastore();
    * const key = datastore.key('Company');
    *
+   * ```
    * @example
+   * ```
    * //-
    * // Create a complete key with a kind value of `Company` and id`123`.
    * //-
    * const {Datastore} = require('@google-cloud/datastore');
    * const datastore = new Datastore();
    * const key = datastore.key(['Company', 123]);
    *
+   * ```
    * @example
+   * ```
    * //-
    * // If the ID integer is outside the bounds of a JavaScript Number
    * // object, create an Int.
@@ -311,14 +322,18 @@ export namespace entity {
    *   datastore.int('100000000000001234')
    * ]);
    *
+   * ```
    * @example
+   * ```
    * const {Datastore} = require('@google-cloud/datastore');
    * const datastore = new Datastore();
    * // Create a complete key with a kind value of `Company` and name `Google`.
    * // Note: `id` is used for numeric identifiers and `name` is used otherwise.
    * const key = datastore.key(['Company', 'Google']);
    *
+   * ```
    * @example
+   * ```
    * //-
    * // Create a complete key from a provided namespace and path.
    * //-
@@ -329,7 +344,9 @@ export namespace entity {
    *   path: ['Company', 123]
    * });
    *
-   * @example <caption>Serialize the key for later re-use.</caption>
+   * ```
+   * @example Serialize the key for later re-use.
+   * ```
    * const {Datastore} = require('@google-cloud/datastore');
    * const datastore = new Datastore();
    * const key = datastore.key({
@@ -338,6 +355,7 @@ export namespace entity {
    * });
    * // Later...
    * const key = datastore.key(key.serialized);
+   * ```
    */
   export class Key {
     namespace?: string;
@@ -400,13 +418,15 @@ export namespace entity {
      * @returns {object}
      *
      * @example
+     * ```
      * const key = datastore.key({
      *   namespace: 'My-NS',
      *   path: ['Company', 123]
      * });
      *
      * // Later...
      * const key = datastore.key(key.serialized);
+     * ```
      */
     get serialized() {
       const serializedKey = {
@@ -484,6 +504,7 @@ export namespace entity {
    * @returns {*}
    *
    * @example
+   * ```
    * decodeValueProto({
    *   booleanValue: false
    * });
@@ -498,6 +519,7 @@ export namespace entity {
    *   blobValue: Buffer.from('68656c6c6f')
    * });
    * // <Buffer 68 65 6c 6c 6f>
+   * ```
    */
   export function decodeValueProto(
     valueProto: ValueProto,
@@ -561,10 +583,12 @@ export namespace entity {
    * @returns {object}
    *
    * @example
+   * ```
    * encodeValue('Hi');
    * // {
    * //   stringValue: 'Hi'
    * // }
+   * ```
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   export function encodeValue(value: any, property: string): ValueProto {
@@ -683,6 +707,7 @@ export namespace entity {
    * @returns {object}
    *
    * @example
+   * ```
    * entityFromEntityProto({
    *   properties: {
    *     map: {
@@ -698,6 +723,7 @@ export namespace entity {
    * // {
    * //   name: 'Stephen'
    * // }
+   * ```
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   export function entityFromEntityProto(
@@ -725,6 +751,7 @@ export namespace entity {
    * @returns {object}
    *
    * @example
+   * ```
    * entityToEntityProto({
    *   excludeFromIndexes: [
    *     'name'
@@ -746,6 +773,7 @@ export namespace entity {
    * //     }
    * //   }
    * // }
+   * ```
    */
   export function entityToEntityProto(entityObject: EntityObject): EntityProto {
     const properties = entityObject.data;
@@ -905,6 +933,7 @@ export namespace entity {
    *     Please see {@link IntegerTypeCastOptions} for options descriptions.
    *
    * @example
+   * ```
    * request_('runQuery', {}, (err, response) => {
    *   const entityObjects = formatArray(response.batch.entityResults);
    *   // {
@@ -915,6 +944,7 @@ export namespace entity {
    *   // }
    *   //
    * });
+   * ```
    */
   export function formatArray(
     results: ResponseResult[],
@@ -984,8 +1014,10 @@ export namespace entity {
    * @returns {boolean}
    *
    * @example
+   * ```
    * isKeyComplete(new Key(['Company', 'Google'])); // true
    * isKeyComplete(new Key('Company')); // false
+   * ```
    */
   export function isKeyComplete(key: Key) {
     const lastPathElement = entity.keyToKeyProto(key).path!.pop()!;
@@ -1000,6 +1032,7 @@ export namespace entity {
    * @returns {Key}
    *
    * @example
+   * ```
    * const key = keyFromKeyProto({
    *   partitionId: {
    *     projectId: 'project-id',
@@ -1012,6 +1045,7 @@ export namespace entity {
    *     }
    *   ]
    * });
+   * ```
    */
   export function keyFromKeyProto(keyProto: KeyProto): Key {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1052,6 +1086,7 @@ export namespace entity {
    * @returns {object}
    *
    * @example
+   * ```
    * const keyProto = keyToKeyProto(new Key(['Company', 1]));
    * // {
    * //   path: [
@@ -1061,6 +1096,7 @@ export namespace entity {
    * //     }
    * //   ]
    * // }
+   * ```
    */
   export function keyToKeyProto(key: Key): KeyProto {
     if (is.undefined(key.kind)) {
@@ -1118,6 +1154,7 @@ export namespace entity {
    * @returns {object}
    *
    * @example
+   * ```
    * queryToQueryProto({
    *   namespace: '',
    *   kinds: [
@@ -1142,6 +1179,7 @@ export namespace entity {
    * //   order: [],
    * //   groupBy: []
    * // }
+   * ```
    */
   export function queryToQueryProto(query: Query): QueryProto {
     const OP_TO_OPERATOR = {

src/index-class.ts

@@ -62,9 +62,11 @@ export type IIndex = google.datastore.admin.v1.IIndex;
  * @param {string} id The index name or id.
  *
  * @example
+ * ```
  * const {Datastore} = require('@google-cloud/datastore');
  * const datastore = new Datastore();
  * const index = datastore.index('my-index');
+ * ```
  */
 export class Index {
   datastore: Datastore;