cache icon indicating copy to clipboard operation
cache copied to clipboard

Rename `restore-keys` to `fallback-keys` or `backup-keys` or `partial-restore-keys`

Open PaulRBerg opened this issue 8 months ago • 1 comments

Several users are confused about what restore-keys actually does or in what contexts it should be used.

See this StackOverflow Q&A.

A more intuitive name would be fallback-keys, backup-keys, or partial-restore-keys.

PaulRBerg avatar Apr 15 '25 13:04 PaulRBerg

I got here after still being confused how this caching action works. I don't think renaming it will suffice. The description should be refined as well.

An ordered multiline string listing the prefix-matched keys, that are used for restoring stale cache if no cache hit occurred for key.

This doesn't make sense to me. So I've got we have an ordered multiline string, but what is a prefix-matched key? and what does it mean they are used for "restoring stale cache". Why would we restore a stale cache if no cache hit occurred for a key?

olsonpm avatar Sep 03 '25 22:09 olsonpm