Updated docs

Author: alexdriedger

README.md

@@ -30,7 +30,7 @@
 
 # About
 
-Pontoon is an open source, self-hosted, data export platform. We built Pontoon from the ground up for the use case of shipping data products to your enterprise customers. APIs are painful to work with at modern data scale and Pontoon is built to make it easy to sync data directly to your customer's data warehouse. Your customers get their data, without needing to build ETLs or pay for ETL tools, empowering them to make data driven decisions for their business with data from your product. Welcome to the future of customer data syncs 🚀
+Pontoon is an open source, self-hosted, data export platform. We built Pontoon from the ground up for the use case of shipping data products to your enterprise customers. APIs are painful to work with at modern data scale and Pontoon is built to make it easy to sync data directly to your customer's data warehouse. Your customers get their data, without needing to build ETLs or pay for ETL tools, empowering them to make data driven decisions for their business, with data from your product. Welcome to the future of customer data syncs 🚀
 
 > Want to get Pontoon up and running in minutes? Try our [Quick Start Guide](https://pontoon-data.github.io/Pontoon/getting-started/quick-start/).
 
@@ -43,8 +43,8 @@ Pontoon is an open source, self-hosted, data export platform. We built Pontoon f
 - **🚀 Easy Deployment**: [Get started](https://pontoon-data.github.io/Pontoon/getting-started/quick-start/) in minutes with Docker or deploy to [AWS Fargate](https://pontoon-data.github.io/Pontoon/getting-started/aws-fargate/)
 - **🎯 Major Data Warehouses Integrations**: Supports [Snowflake](https://www.snowflake.com/), [Google BigQuery](https://cloud.google.com/bigquery), [Amazon Redshift](https://aws.amazon.com/redshift/), and [Postgres](https://www.postgresql.org/) as sources and destinations
 - **☁️ Multi-cloud**: Send data from any cloud to any cloud. Amazon Redshift ➡️ Google BigQuery? No problem!
-- **🏗️ Built for Scale**: Sync over 1 million records per minutea
-- **⚡ Automated Syncs**: Schedule data transfers with automatic backfills and incremental loads
+- **⚡ Automated Syncs**: Schedule data transfers with automatic backfills. Incremental loads automatically keep destination datasets in sync
+- **🏗️ Built for Scale**: Sync over 1 million records per minute
 - **✨ Web Interface**: User-friendly dashboard for managing syncs, built with React/Nextjs
 - **🔌 REST API**: Programmatic access to all Pontoon features, built with FastAPI
 
@@ -65,7 +65,7 @@ Pontoon solves these problems with:
 
 - **Direct Warehouse Integration**: Send data directly to customer's data warehouse. No more ETLs needed!
 - **Scalable Architecture**: Handle millions of rows efficiently. Say goodbye to rate limits!
-- **Scheduled Syncs**: Automate data delivery with automatic backfills on the first sync
+- **Automated Scheduled Syncs**: Automatically keep destinations up to date, only syncing data that's changed/new. Backfills are completed on the first sync.
 - **Self-Hosted**: Full control over your data and infrastructure
 
 # Is Pontoon Just Another ETL Platform?
@@ -96,7 +96,11 @@ docker run \
     ghcr.io/pontoon-data/pontoon/pontoon-unified:latest
 ```
 
-To view the Web UI: `localhost:3000`. To view the OpenAPI docs / test the API: `localhost:8000/docs`
+> Note: If you're using CMD or Powershell, run the command in one line, without `\`
+
+To view the Web UI: `localhost:3000`. To view the OpenAPI docs / test the API: `localhost:8000/docs`.
+
+Check out the [transfer quick start guide](https://pontoon-data.github.io/Pontoon/getting-started/transfer-quick-start/) to add your first source and destination.
 
 ## Running Pontoon with Docker Compose
 
@@ -107,3 +111,7 @@ To build Pontoon from source, use Docker Compose.
 ```sh
 docker compose up --build
 ```
+
+## Creating Your First Data Export
+
+To quickly set up your first transfer in Pontoon, follow the steps in the [transfer quick start](https://pontoon-data.github.io/Pontoon/getting-started/transfer-quick-start/) guide!

docs/docs/assets/destination-creation.png

@@ -4,7 +4,7 @@ Deploy Pontoon using Docker Compose for production environments with full contro
 
 ## Prerequisites
 
-- **Docker** & **Docker Compose V2** ([Docker Desktop](https://docs.docker.com/compose/install/))
+- **Docker** & **Docker Compose V2** ([Install](https://docs.docker.com/compose/install/))
 
 ## Step 1: Clone the Repository
 

docs/docs/assets/model-creation.png

@@ -26,4 +26,6 @@ docker run \
 
 Navigate to `http://localhost:3000` to start exploring Pontoon or checkout the API docs at `http://localhost:8000/docs`.
 
-To learn about adding a source, check out the [Sources & Destinations documentation](../sources-destinations/overview.md).
+The [Transfer Quick Start Guide](./transfer-quick-start.md) has the next steps for building your first data sync!
+
+To learn more about a specific source or destination, check out the [Sources & Destinations docs](../sources-destinations/overview.md).

docs/docs/assets/recipient-creation.png

@@ -6,8 +6,6 @@ Here's how to quickly set up your first transfer in Pontoon. Follow these steps
 
 A source defines a connection to a database that holds data you want to sync. For detailed configuration instructions for each source type, see our [Sources & Destinations documentation](../sources-destinations/overview.md).
 
-<!-- TODO: Add screenshot of adding a source form -->
-
 To add a source:
 
 1. Navigate to the Sources page in the Pontoon web interface
@@ -16,6 +14,8 @@ To add a source:
 4. Configure the connection details for your data source
 5. Test the connection to ensure it's working properly
 
+![Add Source form](../assets/source-creation.png)
+
 ## Step 2: Adding a Model
 
 A model defines a dataset that is ready for export to recipients. Models are multi-tenant, with the `tenant_id` defining which row belongs to which customer.
@@ -30,6 +30,8 @@ When creating a model, you'll need to configure three critical fields:
 
 - **Tenant ID**: An identifier used to associate data with specific customers. This same tenant ID will be used when adding recipients, creating the link between your data and who receives it.
 
+![Add Model form](../assets/model-creation.png)
+
 ## Step 3: Adding a Recipient
 
 Recipients are the customers or organizations that will receive your data. Each recipient is associated with a specific tenant ID.
@@ -43,12 +45,12 @@ To add a recipient:
 3. Enter the recipient's details including their unique tenant ID
 4. Save the recipient configuration
 
+![Add Recipient form](../assets/recipient-creation.png)
+
 ## Step 4: Adding a Destination
 
 A destination defines where your data will be sent. This could be a data warehouse or another database.
 
-<!-- TODO: Add screenshot of adding a destination form -->
-
 For detailed configuration instructions for each destination type, see our [Sources & Destinations documentation](../sources-destinations/overview.md).
 
 To add a destination:
@@ -60,6 +62,8 @@ To add a destination:
 5. Configure the connection details
 6. Test the connection to ensure it's working properly
 
+![Add Destination form](../assets/destination-creation.png)
+
 ## Step 5: Begin a Transfer
 
 Once you have configured add a destination, it will kick off an initial sync to backfill data. Click on a destination and navigate to the transfers tab to see the status of the transfer