Skip to content

Document why shape handles get deleted - #4097

Merged
alco merged 2 commits into
electric-sql:mainfrom
fru1tworld:docs/shape-handle-deletion-reasons
Aug 3, 2026
Merged

Document why shape handles get deleted#4097
alco merged 2 commits into
electric-sql:mainfrom
fru1tworld:docs/shape-handle-deletion-reasons

Conversation

@fru1tworld

Copy link
Copy Markdown
Contributor

Summary

  • Added a "Why shape handles get deleted" section to the shapes guide

Covers: server restart, schema changes, unrecoverable Postgres errors, LRU eviction, explicit API deletion, and client-side behavior.

Fixes #2680

@netlify

netlify Bot commented Apr 7, 2026

Copy link
Copy Markdown

Deploy Preview for electric-next ready!

Name Link
🔨 Latest commit 21d0709
🔍 Latest deploy log https://app.netlify.com/projects/electric-next/deploys/6a7063637f06150008cbbf76
😎 Deploy Preview https://deploy-preview-4097--electric-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@fru1tworld
fru1tworld marked this pull request as ready for review April 7, 2026 05:10
@fru1tworld
fru1tworld force-pushed the docs/shape-handle-deletion-reasons branch from 7e1f86a to 4ca021e Compare May 13, 2026 04:24
Adds a new section to the shapes guide explaining the reasons shapes
are invalidated: replication slot/timeline changes, schema changes,
LRU eviction, and explicit API deletion. Includes what happens on
the client side.

Fixes electric-sql#2680
@fru1tworld
fru1tworld force-pushed the docs/shape-handle-deletion-reasons branch from 4ca021e to c8a12d6 Compare July 21, 2026 02:06

@alco alco left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

👍

@alco
alco merged commit ac9fb39 into electric-sql:main Aug 3, 2026
5 of 8 checks passed
@alco

alco commented Aug 3, 2026

Copy link
Copy Markdown
Member

Thanks for the contribution @fru1tworld !

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.

Feature request: document why a shape handle might get deleted

2 participants