docs: formalize locator refresh state contract #1406

Job	Run time
Tests in Containers (ci-jupyter-container, ubuntu-latest, mcr.microsoft.com/devcontainers/univers...	4m 42s
Tests in Containers (ci-homebrew-container, ubuntu-latest, homebrew/brew, x86_64-unknown-linux-musl)	3m 49s
Tests (macos-14, aarch64-apple-darwin, yes)	14m 50s
Builds (macos-latest, x86_64-apple-darwin, yes)	3m 23s
Tests (macos-latest, x86_64-apple-darwin, yes)	15m 16s
Builds (macos-14, aarch64-apple-darwin, yes)	2m 27s
Builds (ubuntu-latest, x86_64-unknown-linux-musl, yes)	2m 11s
Env Tests (ci-poetry-global, ubuntu-latest, x86_64-unknown-linux-musl)	2m 47s
Env Tests (ci-poetry-project, ubuntu-latest, x86_64-unknown-linux-musl)	3m 3s
Env Tests (ci-poetry-custom, ubuntu-latest, x86_64-unknown-linux-musl)	2m 57s
Builds (windows-latest, aarch64-pc-windows-msvc)	4m 47s
Builds (windows-latest, x86_64-pc-windows-msvc)	7m 4s
Tests (ubuntu-latest, x86_64-unknown-linux-musl, yes)	9m 29s
Tests (windows-latest, x86_64-pc-windows-msvc, yes)	15m 9s
Env Tests (ci-poetry-global, windows-latest, x86_64-pc-windows-msvc)	6m 20s
Env Tests (ci-poetry-project, windows-latest, x86_64-pc-windows-msvc)	5m 45s
Env Tests (ci-poetry-custom, windows-latest, x86_64-pc-windows-msvc)	5m 27s
	1h 49m 26s

Provide feedback