docs(readme): add Troubleshooting section#34
Merged
Conversation
Covers the three most common 400s users will hit — delete manifests, connection test failure (with the four likely causes in order of how often they turn up), the "query is slow" triage flow, and the read-only SQL guard — with the concrete fix for each. Also updates the Test Connection blurb to mention the format, row count, file count, and snapshot age the panel now shows (from PR #28). File stays at 277 lines — well under the ~500-line split threshold.
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.
Captures the three most common failure modes users will hit, with the concrete fix for each, so the answer to "how do I…?" doesn't need a round-trip through GitHub issues:
Also tweaks the Test Connection blurb to mention the format / rows / files / snapshot info the Connection panel now surfaces after PR #28.