Closed
Description
For ion-rust v1.0, we'd like to stabilize a subset of the library's APIs that we believe is both useful and unlikely to change in the near future--the Element API. (Note that while Element is useful, it is not complete; we intend to APIs for accessing deeply nested values and providing stronger typing.)
To this end, we plan to begin migrating APIs that are likely to change soon behind feature flags to communicate to users that they do not yet come with any backwards compatibility guarantees between versions. At a minimum, this includes IonReader, IonWriter, and their respective implementations. Users can continue to use them as they have been by opting into their experimental nature explicitly.