[AI] docs(sync): cross-link troubleshooting sections to shape-handle deletion taxonomy - #4750
Open
dikshit-n wants to merge 1 commit into
Open
Conversation
…ion taxonomy PR electric-sql#4097 (merged 2026-08-03) added a 'Why shape handles get deleted' taxonomy in website/docs/sync/guides/shapes.md. Users hitting 409 responses in the troubleshooting guide benefit from a direct path to that taxonomy. This commit adds two reciprocal cross-links in website/docs/sync/guides/troubleshooting.md: 1. End of 'Unexpected 409 — why is my shape handle invalid?' section: points to the full taxonomy (replication slot, schema, eviction, explicit API, client-side behavior). 2. End of 'Replication slot recreation — why are all clients resyncing after a crash?' section: points to the broader taxonomy (replication slot or timeline, schema, eviction, explicit API). Docs-only change, no behavior modification, no schema change. Follows up on @alco's 2026-08-03 invitation on issue electric-sql#2680 ('@dikshit-n I have merged @fru1tworld's PR. Feel free to suggest further improvements if you have any'). Total: +4 lines, 1 file, 0 deletions.
✅ Deploy Preview for electric-next ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
PR #4097 (merged 2026-08-03) added a "Why shape handles get deleted" taxonomy in website/docs/sync/guides/shapes.md. Users hitting
409responses in the troubleshooting guide benefit from a direct path to that taxonomy.This PR adds two reciprocal cross-links in website/docs/sync/guides/troubleshooting.md:
Docs-only change, no behavior modification, no schema change. Follows up on @alco's 2026-08-03 invitation on issue #2680 ("@dikshit-n I have merged @fru1tworld's PR. Feel free to suggest further improvements if you have any").
Changes
website/docs/sync/guides/troubleshooting.md: +4 lines, -0 linesTesting
why-shape-handles-get-deletedresolves to the new section inshapes.md(VitePress auto-generates anchors from heading text)./docs/sync/guides/shapes#why-shape-handles-get-deletedpath style as the existingSee the troubleshooting guidelink in PR Document why shape handles get deleted #4097, so the link shape is consistent with the new section's outbound references.AI Usage Disclosure
The initial implementation was drafted with Claude and then reviewed, edited, and tested by me.
Checklist
main; rebase-friendly (no merge commits)Related
Need help on this PR? Tag
@codesmith-botwith what you need. Autofix is disabled.