DOC: Add timeseries.stream_async to Python client

Author: cjdsellers

databento/historical/api/timeseries.py

@@ -36,6 +36,12 @@ def stream(
 
         Makes a `GET /timeseries.stream` HTTP request.
 
+        Primary method for getting historical intraday market data, daily data,
+        instrument definitions and market status data directly into your application.
+
+        This method only returns after all of the data has been downloaded,
+        which can take a long time. For large requests, consider using a batch download.
+
         Parameters
         ----------
         dataset : Dataset or str
@@ -128,6 +134,12 @@ async def stream_async(
 
         Makes a `GET /timeseries.stream` HTTP request.
 
+        Primary method for getting historical intraday market data, daily data,
+        instrument definitions and market status data directly into your application.
+
+        This coroutine will complete once all of the data has been downloaded,
+        which can take a long time. For large requests, consider using a batch download.
+
         Parameters
         ----------
         dataset : Dataset or str