docs: formalize locator refresh state contract (#415) #1430

Job	Run time
Tests in Containers (ci-jupyter-container, ubuntu-latest, mcr.microsoft.com/devcontainers/univers...	4m 37s
Builds (windows-latest, aarch64-pc-windows-msvc)	5m 42s
Tests in Containers (ci-homebrew-container, ubuntu-latest, homebrew/brew, x86_64-unknown-linux-musl)	3m 55s
Tests (macos-latest, x86_64-apple-darwin, yes)	15m 20s
Tests (macos-14, aarch64-apple-darwin, yes)	10m 30s
Tests (windows-latest, x86_64-pc-windows-msvc, yes)	7m 56s
Tests (ubuntu-latest, x86_64-unknown-linux-musl, yes)	9m 35s
Env Tests (ci-poetry-project, ubuntu-latest, x86_64-unknown-linux-musl)	2m 54s
Builds (macos-latest, x86_64-apple-darwin, yes)	3m 13s
Builds (windows-latest, x86_64-pc-windows-msvc)	4m 49s
Builds (ubuntu-latest, x86_64-unknown-linux-musl, yes)	2m 16s
Env Tests (ci-poetry-global, windows-latest, x86_64-pc-windows-msvc)	6m 14s
Builds (macos-14, aarch64-apple-darwin, yes)	2m 5s
Env Tests (ci-poetry-project, windows-latest, x86_64-pc-windows-msvc)	5m 59s
Env Tests (ci-poetry-custom, ubuntu-latest, x86_64-unknown-linux-musl)	3m 10s
Env Tests (ci-poetry-global, ubuntu-latest, x86_64-unknown-linux-musl)	2m 49s
Env Tests (ci-poetry-custom, windows-latest, x86_64-pc-windows-msvc)	8m 59s
	1h 40m 3s

Provide feedback