ion-java
ion-java copied to clipboard
De-emphasize Facet in other documentation (e.g. IonReader)
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 even when Facets were completely irrelevant.
Personally, I find Facets
, even when used as intended to be confusing.
I understand the goal is to encapsulate the implementation, but the indirection is difficult. Specifically, it's really hard to "see" what facets each object provides from the code.
I would suggest an entirely different mechanism for a future API.