[Django] #37129: Cache docs incompletely characterize when culling happens

[Django]

#37129: Cache docs incompletely characterize when culling happens
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Type:
| Cleanup/optimization
Status: new | Component:
| Documentation
Version: 6.0 | Severity: Normal
Keywords: cache | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
See [https://forum.djangoproject.com/t/django-database-cache-untouched-
expired-entries-are-never-culled-unless-max-entries-is-reached/22679 forum
post]: the cache docs incompletely describe how expired entries are
culled:

> Instead, expired cache entries are culled each time add(), set(), or
touch() is called.

"Each time" neglects the role of `MAX_ENTRIES` here. (You have to exceed
`MAX_ENTRIES` before any culling is done.)
--
Ticket URL: <https://code.djangoproject.com/ticket/37129>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#37129: Cache docs incompletely characterize when culling happens

--------------------------------------+------------------------------------
Reporter: Jacob Walls | Owner: (none)

Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 6.0

Severity: Normal | Resolution:
Keywords: cache | Triage Stage: Accepted

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0

--------------------------------------+------------------------------------
Changes (by Sarah Boyce):

* stage: Unreviewed => Accepted

Comment:

Thank you!
For others, I believe this area of the docs is being discussed:
https://docs.djangoproject.com/en/6.0/topics/cache/#database-
caching:~:text=Unlike,called
--
Ticket URL: <https://code.djangoproject.com/ticket/37129#comment:1>

[Django]

#37129: Cache docs incompletely characterize when culling happens

-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: VIZZARD-X
Type: | Status: assigned
Cleanup/optimization |

Component: Documentation | Version: 6.0
Severity: Normal | Resolution:
Keywords: cache | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0

-------------------------------------+-------------------------------------
Changes (by VIZZARD-X):

* owner: (none) => VIZZARD-X
* status: new => assigned

--
Ticket URL: <https://code.djangoproject.com/ticket/37129#comment:2>

[Django]

#37129: Cache docs incompletely characterize when culling happens
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: VIZZARD-X
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 6.0
Severity: Normal | Resolution:
Keywords: cache | Triage Stage: Accepted

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by VIZZARD-X):

* has_patch: 0 => 1

--
Ticket URL: <https://code.djangoproject.com/ticket/37129#comment:3>

[Django]

#37129: Cache docs incompletely characterize when culling happens
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: VIZZARD-X
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 6.0
Severity: Normal | Resolution:

Keywords: cache | Triage Stage: Ready for
| checkin

Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls):

* stage: Accepted => Ready for checkin

--
Ticket URL: <https://code.djangoproject.com/ticket/37129#comment:4>

[Django]

#37129: Cache docs incompletely characterize when culling happens
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: VIZZARD-X

Type: | Status: closed

Cleanup/optimization |
Component: Documentation | Version: 6.0

Severity: Normal | Resolution: fixed

Keywords: cache | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls <jacobtylerwalls@…>):

* resolution: => fixed
* status: assigned => closed

Comment:

In [changeset:"1d714484f67777e586fbea49ec743a7e39cba50f" 1d71448]:
{{{#!CommitTicketReference repository=""
revision="1d714484f67777e586fbea49ec743a7e39cba50f"
Fixed #37129 -- Clarified database cache culling behavior in docs.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/37129#comment:5>

[Django]

#37129: Cache docs incompletely characterize when culling happens
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: VIZZARD-X
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 6.0
Severity: Normal | Resolution: fixed
Keywords: cache | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Jacob Walls <jacobtylerwalls@…>):

In [changeset:"d45fc0a5e08578ed8a9eb0726b2a28838e84e4c4" d45fc0a]:
{{{#!CommitTicketReference repository=""
revision="d45fc0a5e08578ed8a9eb0726b2a28838e84e4c4"
[6.1.x] Fixed #37129 -- Clarified database cache culling behavior in docs.

Backport of 1d714484f67777e586fbea49ec743a7e39cba50f from main.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/37129#comment:6>