lidavidm commented on code in PR #35178:
URL: https://github.com/apache/arrow/pull/35178#discussion_r1180943748
##########
docs/source/format/Flight.rst:
##########
@@ -90,9 +90,14 @@ A client that wishes to download the data would:
An endpoint contains a list of locations (server addresses) where
this data can be retrieved from, and a ``Ticket``, an opaque binary
token that the server will use to identify the data being
- requested. There is no ordering defined on endpoints or the data
- within, so if the dataset is sorted, applications should return
- data in a single endpoint.
+ requested. If ``FlightInfo.ordered`` is set, returned endpoints are
+ in the same order as the data. Otherwise, there is no ordering
+ defined on endpoints or the data within. The client can read
+ ordered data by reading data from returned endpoints in order from
+ front to back. Note that a client may ignore
+ ``FlightInfo.ordered``. If an ordering is important and the client
+ may ignore ``FlightInfo.ordered``, applications should return data
+ in a single endpoint.
Review Comment:
Thanks for the suggestion - the new wording sounds good to me (Kou already
pointed out the typo)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
