Deleted unwanted methods, added Javadoc to the ones we keep

May want to check the javadoc there... It's probably less than ideal. Maybe we should pull in the docs team on that?
Also, review the comments on the `Cache` interface... am unsure about some methods there
Think this may become more complex at some point... but if we include the `Iterator` as part of this, I guess we need it already