First pass of Heroku rewrite [DOC-233]

Author: forstisabella

src/connections/storage/catalog/postgres/index.md

@@ -8,6 +8,9 @@ PostgreSQL, or Postgres, is an object-relational database management system (ORD
 
 PostgreSQL is ACID-compliant and transactional. PostgreSQL has updatable views and materialized views, triggers, foreign keys; supports functions and stored procedures, and other expandability. Developed by the PostgreSQL Global Development Group, free and open-source.
 
+> note "Segment sources required"
+> In order to add a Postgres destination to Segment, you must first add a source. To learn more about sources in Segment, check out our [Sources Overview](/docs/connections/sources) documentation.
+
 ## Getting started
 Segment supports the following Postgres database providers:
 - [Heroku](#heroku-postgres)
@@ -21,51 +24,30 @@ Segment supports the following Postgres database providers:
 
 This guide explains how to set up a Postgres database with Heroku. Heroku is a cloud-based platform-as-a-service which simplifies the process of setting up and administering a Postgres database.
 
-1. Sign up for a Heroku account.
-
-    The first step to setting up Postgres on Heroku is to get a Heroku account. You can sign up for a free account [here](https://signup.heroku.com/identity){:target="_blank"}.
-
-2. Log in to your Heroku account.
-
-    You can log in to Heroku [here](https://id.heroku.com/login){:target="_blank"}.
-
-3. Create a new app and go to the Data page.
-
-    To get to the Data page, in the Dashboard menu dropdown, select Data.
-
-    ![](images/heroku1.png)
-
-4. Create a Database.
-
-    From the **Data** page, find the Heroku Postgres heading and click **Create one**.
-
-    <img src="images/heroku2.png" width="300">
-
-5. Choose your plan.
-
-    When you click **Create Database**, a modal appears with your plan choices. Depending on your needs, some plans may be more suitable than others - for example, more expensive plans generally have better performance and more storage. Segment recommends that new customers start with the "Standard 4" plan.
+1. Sign up for a Heroku account. You can create a free account [on Heroku's website](https://signup.heroku.com/identity){:target="_blank"}.
 
-    For the fastest sync times, choose the US East region.
+2. [Log in](https://id.heroku.com/login){:target="_blank"} to your Heroku account.
 
-    After you configure these settings, click "Login to Install" and/or "Visit Heroku Dashboard to create your first app".
+3. On the landing page, select **Create new app**.
 
-    ![](images/heroku3.png)
+4. Add a name for your app and select the region where you want your host your app. If you have an existing pipeline that you want to add your app to, add it at this step. When you've finished updating your app's settings, click **Create app**.   
 
-6. From your new app, go to the **Resources** tab and add the "Heroku Postgres" Add-on.
+5. On the Deploy page, select the **Resources** tab. 
 
-    ![](images/heroku4.png)
+6. On the **Resources** page, add a new add-on to your app by searching for "Heroku Postgres" in the search bar. Select the plan that you wish to bill the database to, and click **Submit Order Form**. _Learn more about pricing information on [Heroku's website](https://www.heroku.com/pricing#data-services)._
 
-7. Click **Provision** and wait for the database provisioning to complete
+7. From the Deploy page, select the Settings tab. Click the **View Credentials...** button and copy the host, database, user, and password fields. 
 
-    Click the "Heroku Postgres :: Database". The database should shift into the Available state.
+8. Open the Segment app. On the Overview page, click **Add Destination**.
 
-    ![](images/heroku5.png)
+9. Search for and select the Postgres destination.  
 
-8. View the database overview and settings.
+10. Choose the sources you'd like to connect to Postgres, and click **Next**.
 
-    Click the tabs to see the database overview and settings. Click **Settings > View credentials** and save these settings for the next steps of the connection process.
+11. Enter the host, database, user, and password fields you copied in step seven, and click **Connect**. If Segment successfully connected to your destination, you'll see the Next Steps screen. If not, check your host, database, user, and password fields.
 
-    ![](images/heroku6.png)
+> warning "First sync duration"
+> The initial sync between Segment and Heroku Postgres can take up to 24 hours to complete. 
 
 ## RDS Postgres