{"action":"closed","issue":{"url":"https://api.github.com/repos/ionrock/cachecontrol/issues/54","labels_url":"https://api.github.com/repos/ionrock/cachecontrol/issues/54/labels{/name}","comments_url":"https://api.github.com/repos/ionrock/cachecontrol/issues/54/comments","events_url":"https://api.github.com/repos/ionrock/cachecontrol/issues/54/events","html_url":"https://github.com/ionrock/cachecontrol/issues/54","id":53618072,"number":54,"title":"Documentation doesn't explain algorithm used to determine whether to cache based on time","user":{"login":"ssokolow","id":46915,"avatar_url":"https://avatars.githubusercontent.com/u/46915?v=3","gravatar_id":"","url":"https://api.github.com/users/ssokolow","html_url":"https://github.com/ssokolow","followers_url":"https://api.github.com/users/ssokolow/followers","following_url":"https://api.github.com/users/ssokolow/following{/other_user}","gists_url":"https://api.github.com/users/ssokolow/gists{/gist_id}","starred_url":"https://api.github.com/users/ssokolow/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ssokolow/subscriptions","organizations_url":"https://api.github.com/users/ssokolow/orgs","repos_url":"https://api.github.com/users/ssokolow/repos","events_url":"https://api.github.com/users/ssokolow/events{/privacy}","received_events_url":"https://api.github.com/users/ssokolow/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/ionrock/cachecontrol/labels/docs","name":"docs","color":"fef2c0"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-01-07T10:28:10Z","updated_at":"2015-06-29T15:42:18Z","closed_at":"2015-06-29T15:42:18Z","body":"I have a \"cache for the greater of X and the site-specified cache duration\" wrapper that I'd like to convert into a CacheControl heuristic but the documentation doesn't explain how the heuristics system actually interacts with Time Priority caching.\r\n\r\nAs such, I'm forced to dig around in the code to figure out which headers I have to override and in what ways to ensure the desired behaviour. (And while it is very nice, clean code, that's still a documentation bug)"}}