alamb opened a new pull request, #10741: URL: https://github.com/apache/arrow-rs/pull/10741
# Which issue does this PR close? N/A -- documentation only. # Rationale for this change The ability to customize JSON encoding via [`EncoderFactory`] was added in #7015, but neither the crate-level docs nor the writer module docs mention it, so users only find the hook by stumbling on `WriterBuilder::with_encoder_factory`. Notably, the crate-level "Binary Data Encoding" section recommends the `arrow_cast` base64 workaround for which a custom encoder is now a direct answer. [`EncoderFactory`]: https://docs.rs/arrow-json/latest/arrow_json/trait.EncoderFactory.html # What changes are included in this PR? Documentation only, no code changes: - Crate-level docs: list a custom `EncoderFactory` as an alternative for binary data encoding - Writer module docs: new "Customizing the encoder" section linking to `WriterBuilder::with_encoder_factory` and the existing example on `EncoderFactory` - Small wording fixes to the `EncoderFactory` trait docs A matching pointer for customizing *decoding* can be added as part of #10670, which proposes the reader-side equivalent. # Are these changes tested? Covered by existing doc tests and CI rustdoc link checking. # Are there any user-facing changes? Documentation only. -- 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]
