Skip to content

Document the Ingest V2 write path#6593

Draft
fmassot wants to merge 1 commit into
mainfrom
codex/docs-ingest-v2-write-path
Draft

Document the Ingest V2 write path#6593
fmassot wants to merge 1 commit into
mainfrom
codex/docs-ingest-v2-write-path

Conversation

@fmassot

@fmassot fmassot commented Jul 11, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • document the native Ingest V2 request path from REST to the ingester WAL
  • describe control-plane shard creation, replication, and indexing assignment RPCs
  • explain shard acquisition, WAL fetch, split publication, checkpoint fencing, and cleanup
  • clarify commit modes, durability boundaries, Chitchat coordination, and retry semantics

Why

The architecture documentation did not have a current end-to-end view of the write path. This adds a single code-linked reference for the data path and the control-plane, ingester, indexer, and metastore interactions.

Validation

  • reviewed against the current router, ingester, control-plane, indexing, and PostgreSQL metastore implementations
  • verified all 26 relative documentation links resolve
  • git diff --cached --check

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant