Unclear docs for TTL expiration

[balazspeterfi]

Since the new eviction algorithm has been introduced (v3.7) the documentation suggests that the expiration based eviction only happens as part of the eviction sampling, which only occurs when the cache reaches its maximum size. I realised that it's not the case and in fact expiration happens independently from eviction.

The misleading points are:

• time-to-live-seconds and max-idle-seconds are explained under Map Eviction Configuration, and it doesn't say when these expirations get evaluated
• in the Eviction Algorithm section in step 6 it says:

6. The eviction strategy tests whether the sampled entry is already expired (lazy expiration). If expired, the sampling stops and the entry is removed in step 9.

the fact that expiration based eviction is only mentioned here and it's referred as "lazy expiration" gives the false impression that it is the only point when expiration is being checked.

Could you please clarify this in the docs to give a clearer view on how expiration is working?