Part 1: review in #35 2. method should inheritdoc since doc is on the interface.
Part 1: #35 comment part of 6. adding comment about what array intersect is doing. might want an exception when attempted to update things not allowed.