Minor style changes for a RTDB comment block

packages/firebase/index.d.ts

@@ -4838,13 +4838,13 @@ declare namespace firebase.database {
      *
      * This is the most common pattern for adding data to a collection of items.
      *
-     * If you provide a value to `push()`, the value will be written to the
-     * generated location. If you don't pass a value, nothing will be written to the
-     * Database and the child will remain empty (but you can use the `Reference`
+     * If you provide a value to `push()`, the value is written to the
+     * generated location. If you don't pass a value, nothing is written to the
+     * database and the child remains empty (but you can use the `Reference`
      * elsewhere).
      *
-     * The unique key generated by `push()` are ordered by the current time, so the
-     * resulting list of items will be chronologically sorted. The keys are also
+     * The unique keys generated by `push()` are ordered by the current time, so the
+     * resulting list of items is chronologically sorted. The keys are also
      * designed to be unguessable (they contain 72 random bits of entropy).
      *
      *
@@ -4874,9 +4874,8 @@ declare namespace firebase.database {
      * @param value Optional value to be written at the generated location.
      * @param onComplete Callback called when write to server is
      *   complete.
-     * @return Combined `Promise` and
-     *   `Reference`; resolves when write is complete, but can be used immediately
-     *   as the `Reference` to the child location.
+     * @return Combined `Promise` and `Reference`; resolves when write is complete, but can be
+     *   used immediately as the `Reference` to the child location.
      */
     push(
       value?: any,
@@ -5486,13 +5485,13 @@ declare namespace firebase.storage {
     /**
      * List all items (files) and prefixes (folders) under this storage reference.
      *
-     * This is a helper method for calling list() repeatedly until there are
+     * This is a helper method for calling `list()` repeatedly until there are
      * no more results. The default pagination size is 1000.
      *
      * Note: The results may not be consistent if objects are changed while this
      * operation is running.
      *
-     * Warning: listAll may potentially consume too many resources if there are
+     * Warning: `listAll` may potentially consume too many resources if there are
      * too many results.
      *
      * @return A Promise that resolves with all the items and prefixes under
@@ -5513,9 +5512,9 @@ declare namespace firebase.storage {
      * To adhere to Firebase Rules's Semantics, Firebase Storage does not
      * support objects whose paths end with "/" or contain two consecutive
      * "/"s. Firebase Storage List API will filter these unsupported objects.
-     * list() may fail if there are too many unsupported objects in the bucket.
+     * `list()` may fail if there are too many unsupported objects in the bucket.
      *
-     * @param options See ListOptions for details.
+     * @param options See `ListOptions` for details.
      * @return A Promise that resolves with the items and prefixes.
      *      `prefixes` contains references to sub-folders and `items`
      *      contains references to objects in this folder. `nextPageToken`
@@ -5549,7 +5548,7 @@ declare namespace firebase.storage {
   }
 
   /**
-   * The options list() accepts.
+   * The options `list()` accepts.
    */
   interface ListOptions {
     /**
@@ -5558,7 +5557,7 @@ declare namespace firebase.storage {
      */
     maxResults?: number | null;
     /**
-     * The `nextPageToken` from a previous call to list(). If provided,
+     * The `nextPageToken` from a previous call to `list()`. If provided,
      * listing is resumed from the previous position.
      */
     pageToken?: string | null;