Skip to content

Clarify Postgres RDS source docs #19367

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Conversation

jpepin
Copy link
Contributor

@jpepin jpepin commented May 19, 2023

Motivation

Line-specific feedback and tweaks to the Postgres RDS source setup guide, as well as some general feedback.
This isn't mergeable as-is since there is a lot of meta-commentary.
This aligns strongly with MaterializeInc/database-issues#5640

Other Notes

  • The sidebar Connect Sources section of the docs links right to the Postgres CDC page, skipping the top level postrgres source page which has most of the important setup detail. This is just a bit confusing when getting started.
  • We should add a new Troubleshooting section for Connections, or include more detail on the Connection creation page for things like SHOW CREATE CONNECTION. I created a malformed connection the first time around and it was difficult to discover how to see it and then how to fix it (it has to be dropped and recreated). ALTER CONNECTION doesn't do what it looks like it does!
  • It's not immediately obvious which doc sections apply to the Postgres database and which sections apply to Materialize, if you're not already familiar with both.

@jpepin jpepin added the A-docs Area: documentation label May 19, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-docs Area: documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant