Based on CDI-611.
We should update our docs on the same basis so as to make it clearer.
The example we have is superior to that in CDI, however we should still hold on to an explanation based on sets and subset.