added docs about query caching. fixes #1917