Documentation: Update Database.ReadAsync description

Microsoft.Azure.Cosmos/src/Linq/CosmosLinqExtensions.cs

@@ -174,19 +174,19 @@ public static FeedIterator<T> ToFeedIterator<T>(this IQueryable<T> query)
         }
 
         /// <summary>
-        /// This extension method gets the FeedIterator from LINQ IQueryable to execute query asynchronously.
-        /// This will create the fresh new FeedIterator when called.
+        /// This extension method gets the StreamIterator from LINQ IQueryable to execute query asynchronously.
+        /// This will create the fresh new StreamIterator when called.
         /// </summary>
         /// <typeparam name="T">the type of object to query.</typeparam>
         /// <param name="query">the IQueryable{T} to be converted.</param>
         /// <returns>An iterator to go through the items.</returns>
         /// <example>
-        /// This example shows how to get FeedIterator from LINQ.
+        /// This example shows how to get StreamIterator from LINQ.
         ///
         /// <code language="c#">
         /// <![CDATA[
         /// IOrderedQueryable<ToDoActivity> linqQueryable = this.Container.GetItemLinqQueryable<ToDoActivity>();
-        /// using (FeedIterator setIterator = linqQueryable.Where(item => (item.taskNum < 100)).ToFeedIterator()
+        /// using (FeedIterator setIterator = linqQueryable.Where(item => (item.taskNum < 100)).ToStreamIterator())
         /// ]]>
         /// </code>
         /// </example>

Microsoft.Azure.Cosmos/src/Resource/Database/Database.cs

@@ -31,15 +31,18 @@ public abstract class Database
         /// </summary>
         public abstract CosmosClient Client { get; }
 
-        /// <summary>
-        /// Reads a <see cref="DatabaseProperties"/> from the Azure Cosmos service as an asynchronous operation.
+        /// <summary>        
+        /// Reads a <see cref="DatabaseResponse"/> from the Azure Cosmos service as an asynchronous operation.
         /// </summary>
         /// <param name="requestOptions">(Optional) The options for the request.</param>
         /// <param name="cancellationToken">(Optional) <see cref="CancellationToken"/> representing request cancellation.</param>
         /// <returns>
         /// A <see cref="Task"/> containing a <see cref="DatabaseResponse"/> which wraps a <see cref="DatabaseProperties"/> containing the read resource record.
         /// </returns>
         /// <exception>https://aka.ms/cosmosdb-dot-net-exceptions</exception>
+        /// <remarks>
+        /// <see cref="DatabaseResponse.Resource"/> contains the <see cref="DatabaseProperties"/> that include the resource information.
+        /// </remarks>
         /// <example>
         /// <code language="c#">
         /// <![CDATA[