Skip to content

docs: add request path, cache tiering, and git restore docs - #393

Open
worstell wants to merge 1 commit into
mainfrom
worstell/tiering-docs
Open

docs: add request path, cache tiering, and git restore docs#393
worstell wants to merge 1 commit into
mainfrom
worstell/tiering-docs

Conversation

@worstell

@worstell worstell commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Adds three docs pages: docs/architecture.md covers the request path (authorization → interceptors → strategies → cache → upstream) and the Cache contract; docs/tiering.md covers storage tiers (read fallback/backfill, parallel writes, Delete vs Invalidate, ETag-based stale-tier invalidation, ranged-read healing); docs/git-restore.md covers the snapshot/bundle restore flow and parallel ETag-pinned snapshot downloads, including fallback and failure semantics. All linked from the README.

Generated with Amp

@worstell
worstell force-pushed the worstell/tiering-docs branch from dc0d066 to 4c96ace Compare July 21, 2026 19:43
@worstell worstell changed the title Add docs/tiering.md explaining request-path layers and cache tiers Add docs for the request path and cache tiering Jul 21, 2026
@worstell
worstell force-pushed the worstell/tiering-docs branch 2 times, most recently from a922389 to 2728a99 Compare July 21, 2026 19:58
@worstell worstell changed the title Add docs for the request path and cache tiering Add docs for the request path, cache tiering, and git restore Jul 21, 2026
@worstell
worstell force-pushed the worstell/tiering-docs branch from 2728a99 to df4bb09 Compare July 21, 2026 20:02
@worstell worstell changed the title Add docs for the request path, cache tiering, and git restore docs: add request path, cache tiering, and git restore docs Jul 21, 2026
@worstell
worstell marked this pull request as ready for review July 21, 2026 20:03
@worstell
worstell requested a review from a team as a code owner July 21, 2026 20:03
@worstell
worstell requested review from jrobotham-square and removed request for a team July 21, 2026 20:03

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: df4bb09f8a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/tiering.md Outdated
@worstell
worstell force-pushed the worstell/tiering-docs branch from df4bb09 to 3c4e25e Compare July 21, 2026 20:08

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3c4e25ebd4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/git-restore.md Outdated
@worstell
worstell force-pushed the worstell/tiering-docs branch from 3c4e25e to 8105598 Compare July 21, 2026 20:14
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