The issue can come up in implementations that override both addValues and addAll. Maybe in the docs state that this method relies on allValues, since it is an API impacting aspect?