Joshua Barr

`jackson-dataformat-ion` type serialization behavior

4

# jackson-dataformat-ion polymorphic behaviors ## [SSCCE](http://sscce.org/) to demonstrate behaviors. This sample code depends on `jackson-dataformat-ion`, `jackson-annotations`, `jackson-databind`, and `jackson-core`. ```java import com.amazon.ion.IonValue;// for jackson-dataformat-ion 2.10+ // import software.amazon.ion.IonValue; // for...

Add some Ion-to-Native and Native-to-Ion conversion utilities

1

In another channel a user suggested adding additional conversion utilities, including the ability to convert an entire IonPyDict to a native dict type.

In another channel a user suggested this improvement, specifically instantiating Ion values and attaching them to containers, detaching them from containers, etc.

Can/should we raise the Sonatype Safety Rating for ion-java?

3

When you look at [`ion-java` in Maven Central](https://central.sonatype.com/artifact/com.amazon.ion/ion-java) you can see that the project is assigned a safety rating of 5/10. Reading from the [How is the Sonatype Safety Rating...

IonReader documentation does not explain how to get an IonReader

1

See [IonReader javadoc](https://www.javadoc.io/static/com.amazon.ion/ion-java/1.9.6/index.html?com/amazon/ion/IonReader.html). The documentation should include a quick acquisition and usage example.

De-emphasize Facet in other documentation (e.g. IonReader)

1

In recent usability studies, new users were confused by the documentation references to Facets, and tried to find the right Facet for an instance of IonReader to solve their problems...

README should have immediate usage example

1

A quick demonstration of how to use the library goes a ways towards making it approachable.

See e.g. [IonReader javadoc](https://www.javadoc.io/static/com.amazon.ion/ion-java/1.9.6/index.html?com/amazon/ion/IonReader.html). There's discussion of the meaning of `next()` in the interface documentation, but the fact that stream end is signaled by a `null` response from `next()` is...

See [this google search](https://www.google.com/search?q=ionreader), where the top result links to the [1.0.0 javadoc for IonReader](https://www.javadoc.io/static/software.amazon.ion/ion-java/1.0.0/index.html?software/amazon/ion/IonReader.html). What elevates this old (first) version of ion-java in javadoc.io content, compared to the dynamic...