Improve Documentation for Definitions Cache Manager

[cthoyt]

I already added a RST page with automodule, so add the docs in the right format inside the classes, their__init__ methods, and the modules that can get propogated through. You can also add any design notes to manager.rst that you want