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
What was this `.clear()` method all about?