findepi commented on code in PR #6852: URL: https://github.com/apache/arrow-rs/pull/6852#discussion_r1874417410
########## README.md: ########## @@ -82,6 +82,24 @@ versions approximately every 2 months. [`object_store`]: https://crates.io/crates/object_store +### Deprecation Policy + +Minor releases may deprecate, but not remove APIs. Deprecating APIs allows the +Rust programs to still compile, but will generate compiler warnings. This gives +downstream crates time to migrate to non deprecated APIs prior to their removal. + +All deprecated APIs are marked using the `#[deprecated]` attribute with both the +first version they were deprecated in, and what new API to use instead. + +```rust +#[deprecated(since = "51.0.0", note = "Use `date_part` instead")] +``` + +Deprecated APIs will be kept for at least two major releases after they were Review Comment: The PR initially started with 1, now it's 2. This is not unimportant. The less the better from code maint. perspective -- 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]
