-
Notifications
You must be signed in to change notification settings - Fork 367
Updating the Postgres RDS docs [DOC-504] #2822
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
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good!
A few general comments:
- Please add
{:target="_blank"}
to all external URLs. - I'm not sure the troubleshooting section at the bottom needs to be a table. Changing these to headings / paragraphs will help searchability and maintainability. I also noticed one instance of
we
in one of the cells.
|
||
As a supplement to this guide, Amazon has created an official guide to [setting up a Postgres database](http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html). | ||
Create a new PostgreSQL database in RDS by following the steps in Amazon's documentation, [Creating a PostgreSQL DB instance and connecting to a database on a PostgreSQL DB instance](http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html). For best performance, create your database in the `US West` region. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You can reorder the first sentence to make it active-voice.
"Follow the steps in Amazon's documentation to create a new PostgreSQL..."
Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site. |
Proposed changes
I’ve updated the Network Permissions section so that it references correct UI terms, and removed the step-by-step instructions for creating an PostgreSQL database to instead link to AWS’s DB creation docs (so we’re not on the hook for updating the instructions again when AWS makes more UI changes.)
Merge timing
With the next regular docs release, pending approval from the PM for this product!
Related issues (optional)
#2735