Summary

Add a guide on caching data.

Review Request #14873 — Created March 5, 2026 and updated March 6, 2026, 8:18 a.m.

Information

Owner

chipx86

Repository

Djblets

Branch

release-5.x

Bugs

Depends On

Reviewers

Groups

djblets

People

Description

This introduces the first of a series of caching guides, focusing on
using cache_memoize() and cache_memoize_iter(). This covers basic
usage, iterables, force-overrides, large data, compression, encryption,
and locking,all with examples covering both functions.

Testing Done

Built the docs. Checked for build errors, spelling errors, and bad
links.

Commits

Summary	ID
Add a guide on caching data. This introduces the first of a series of caching guides, focusing on using `cache_memoize()` and `cache_memoize_iter()`. This covers basic usage, iterables, force-overrides, large data, compression, encryption, and locking,all with examples covering both functions.	f3844c4ab3151b3720d42cf69d00de6c83a7fddc

Issues

Description	From	Last Updated
Typo in description: locking,all -> locking, all	david	March 6, 2026, 8:18 a.m.
Typo: of of	david	March 6, 2026, 8:18 a.m.
Can we include an import for Iterator?	david	March 6, 2026, 8:18 a.m.
It's probably more correct to say this returns Iterator	david	March 6, 2026, 8:18 a.m.
Typo: ofr -> for Though it might be better to say something like "This is always enabled for cache_memoize_iter"	david	March 6, 2026, 8:18 a.m.

flake8 passed.

JSHint passed.

Fix it!

An issue was opened. Show all issues

Typo in description: locking,all -> locking, all

docs/djblets/guides/caching/caching-data.rst (Diff revision 1)
An issue was opened. Show all issues
```
Typo: of of
```
docs/djblets/guides/caching/caching-data.rst (Diff revision 1)
An issue was opened. Show all issues
```
Can we include an import for Iterator?
```
docs/djblets/guides/caching/caching-data.rst (Diff revision 1)
An issue was opened. Show all issues
```
It's probably more correct to say this returns Iterator
```

docs/djblets/guides/caching/caching-data.rst (Diff revision 1)

An issue was opened. Show all issues

Typo: ofr -> for

Though it might be better to say something like "This is always enabled for cache_memoize_iter"