[PR] docs: Update read returns metadata RFC [opendal]

["Xuanwo (via GitHub)" <gi...@apache.org>]

Xuanwo opened a new pull request, #7623:
URL: https://github.com/apache/opendal/pull/7623

   # Which issue does this PR close?
   
   Updates #5872.
   
   # Rationale for this change
   
   RFC-5871 still described `Reader::metadata()` as the primary API and treated read metadata like full object metadata. The current design needs to support stream-bound read response metadata so adapters such as `object_store_opendal` can build streaming results without an extra stat request.
   
   # What changes are included in this PR?
   
   This updates RFC-5871 to describe stream-bound async metadata access, a cache-only `Reader::metadata()` for complete object metadata observed from reads, and `RpRead` as a metadata-only reply. It also clarifies the `content_length` semantics for read responses and removes the proposed `RpRead::size()` / `RpRead::range()` surface.
   
   # Are there any user-facing changes?
   
   No implementation changes are included. This is an RFC documentation update for the proposed read metadata API.
   
   # AI Usage Statement
   
   OpenAI GPT-5 was used to assist drafting and editing this documentation update.
   


-- 
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: commits-unsubscribe@opendal.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] docs: Update read returns metadata RFC [opendal]

["Xuanwo (via GitHub)" <gi...@apache.org>]

Xuanwo merged PR #7623:
URL: https://github.com/apache/opendal/pull/7623


-- 
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: commits-unsubscribe@opendal.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org