garbage collection policy documentation

[jahupru]

Is this a docs issue?

• My issue is about the documentation content or website

Type of issue

Information is incorrect

Description

Here is the current text:

For example, say you have the following GC policies:

Find "stale" cache records that haven't been used in the past 48 hours, and delete records until there's maximum 5GB of "stale" cache left.
If the build cache size exceeds 10GB, delete records until the total cache size is no more than 10GB.
The first rule is more specific, prioritizing stale cache records and setting a lower limit for a less valuable type of cache. The second rule imposes a higher hard limit that applies to any type of cache records. With these policies, if you have 11GB worth of build cache, where:

7GB of which is "stale" cache
4GB is other, more valuable cache
A GC sweep would delete 5GB of stale cache as part of the 1st policy, with a remainder of 6GB, meaning the 2nd policy does not need to clear any more cache.

I think this statement "A GC sweep would delete 5GB of stale cache as part of the 1st policy" is incorrect.
I think it should say "A GC sweep would delete 2GB of stale cache (down to 5GB) as part of the 1st policy".

The rest of the statement "with a remainder of 6GB" seems to be correct.

Location

https://docs.docker.com/build/cache/garbage-collection/

Suggestion

I think the wording in the documentation could be improved.