ammend specs for caching on the api level
Add documentation.