Better documentation for oat adapters jsonapi collection method

Not sure that this is necessarily the right way to do this, but I think documentation to this effect is necessary.