docs and little progress on new caching stuff