Skip to content

docs: explain post-write search visibility - #707

Merged
vishal-bala merged 1 commit into
redis:mainfrom
pttydou:docs/issue-662-search-visibility
Aug 31, 2026
Merged

docs: explain post-write search visibility#707
vishal-bala merged 1 commit into
redis:mainfrom
pttydou:docs/issue-662-search-visibility

Conversation

@pttydou

@pttydou pttydou commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Explain the Redis 8.8+ search visibility window under concurrent writes and queries when background search workers are enabled.
  • Clarify that the data remains in the keyspace and that the reported 1–3 ms convergence is an observation, not a latency guarantee.
  • Document the Redis server-side --search-workers 0 option and its indexing-throughput trade-off.

Validation

  • uv run --frozen sphinx-build -b html docs docs/_build/html --keep-going (passed; 12 pre-existing warnings in untouched files)
  • uv run --frozen codespell docs/concepts/search-and-indexing.md
  • git diff --check

Documentation-only (auto:documentation).

Fixes #662.


Note

Low Risk
Documentation-only change with no runtime or API impact.

Overview
Adds a Search Visibility After Writes section to the search-and-indexing concept doc, describing how Redis 8.8+ with background search-workers can briefly hide newly written documents from immediate queries (e.g. right after load()).

The new text frames this as indexing lag rather than data loss, cites issue #662’s ~1–3 ms observations without treating them as an SLA, and documents the Redis server flag --search-workers 0 for strict read-after-write at the cost of background indexing throughput.

Reviewed by Cursor Bugbot for commit 4e158fb. Bugbot is set up for automated code reviews on this repo. Configure here.

@vishal-bala vishal-bala added the auto:documentation Changes only affect the documentation label Aug 31, 2026
@vishal-bala
vishal-bala self-requested a review August 31, 2026 15:17
@vishal-bala
vishal-bala merged commit 6cb3f92 into redis:main Aug 31, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto:documentation Changes only affect the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: loaded documents may not be immediately searchable on Redis 8.8+ under concurrent load

2 participants