Design clear caching protocol #226
Description
This should be implemented in the docs/examples as a proposed API.
The cache protocol must clearly define:
- possible types of cache configurations
- how these configurations are specified (config file, python, CLI)
- what is cached on write for each cache configuration
- what is cached on read for each cache configuration
- any modifications that can be made to the defaults using method flags/CLI args
In addition, it should clearly articulate how users are expected to interact with the cache in each of our main uses cases (big servers, e.g. Sacagawea, and personal/OSDC machines) including cache management.