Merge pull request #20 from mongodb-developer/schema-create-project

Improved how to create the project

Author: dfreniche

docs/30-schema-in-postgresql.mdx

@@ -2,8 +2,9 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 📘 Schema in PostgreSQL
 
-The following screenshot shows an entity-relationship diagram of the relational database we wish to migrate. This is a library management app that stores information about books, where a book can have many authors, an author can write many books, and users can borrow books and leave reviews.
+The following screenshot shows an entity-relationship diagram of the relational database we wish to migrate. This is a library management app that stores information about books, where a book can have many authors, an author can write many books, and users can borrow books and leave reviews. You can have many copies of the same book (issue_details) and those are what users borrow and return. A library user can have many addresses.
 
 This is the sample schema we use during our [Developer Days's Intro Lab](https://mongodb-developer.github.io/intro-lab/docs/importing-data/intro).
 
-<Screenshot url="https://www.mongodb.com/products/tools/relational-migrator" src="img/30-image-001.png" alt="Screenshot of the connect modal" />
+[![Screenshot of the PostgreSQL ERD](/img/30-image-001.png)](/img/30-image-001.png)
+_Click to enlarge in a new tab / window_

docs/50-create-project/50-create-new-project.mdx

@@ -9,11 +9,11 @@ Ensure Relational Migrator is installed and running (usually at http://127.0.0.1
 ## Click on New Project
 
 
-<Screenshot url="https://www.mongodb.com/products/tools/relational-migrator" src="img/50-image-001.png" alt="Screenshot of the connect modal" />
+<Screenshot url="http://127.0.0.1:8278" src="img/50-image-001.png" alt="Screenshot of the connect modal" />
 
 ## Select one of the three options
-- Click **Connect to live database** if you are running the origin DB in the cloud, Docker or using your own hardware.
+- Click **Connect database** if you are running the origin DB in the cloud, Docker or using your own hardware.
 - Click **Load schema from a file** if you don't have access to a source database and just want to work with the schema (you won't have any data to import though).
 - Click **Use a sample schema** to play around with a test schema, without any data. This does not require connecting to a real DB. We won't use this one in this Lab.
 
-<Screenshot url="https://www.mongodb.com/products/tools/relational-migrator" src="img/50-image-002.png" alt="Screenshot of the connect modal" />
+<Screenshot url="http://127.0.0.1:8278" src="img/50-image-002.png" alt="Screenshot of the connect modal" />

docs/50-create-project/60-connect-database.mdx

@@ -2,19 +2,29 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 Connect to the Database
 
+## Add a new connection
+
+We can store the credentials of our database so in the next session we can connect quickly. In this case, we'll create a new connection selecting "Add a new connection". 
+
 ## Select PostgreSQL as Database Type
 
+Then we'll select PostgreSQL as our source database.
+
 <Screenshot url="https://www.mongodb.com/products/tools/relational-migrator" src="img/60-image-000.png" alt="Selecting PostgreSQL as Database" />
 
 ## Enter connection details
 
 Enter the details for the PostgreSQL database you will be migrating from.
 
- - If your instructors have configured a server for you to use, ask them for the host name, username and password. It's important to click on the `SSL` tab and active SSL.
- - If you followed the steps to configure PostgreSQL in a docker container, the hostname will be `localhost`, username `postgres` and password `postgres`. 
-
-Click `Test Connection` to ensure your details are correct.
-
-Click `Connect` to proceed to the next step.
+- It's important to click on the `SSL` tab and activate SSL (SSL mode Prefer is fine), otherwise we won't be able to connect to cloud hosted databases.
+- If your instructors have configured a server for you to use, ask them for the host name, username and password. 
+- Database name should be "library"
+- Click `Test Connection` to ensure your details are correct.
+- Click `Connect` to proceed to the next step.
+- You can give your connection a name and a tag to make it simpler to remember later
 
 <Screenshot url="https://www.mongodb.com/products/tools/relational-migrator" src="img/60-image-001.png" alt="Screenshot of the connect modal" />
+
+:::info
+🦸‍♂️ If you have followed the steps to configure PostgreSQL in a docker container, the hostname will be `localhost`, username `postgres` and password `postgres`. 
+:::

docs/50-create-project/70-select-tables.mdx

@@ -2,6 +2,10 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 Select Tables
 
-We want to migrate data from all of the tables, so check all of them and then click `Next`.
+We want to migrate data from all of the tables, so check all of them (just check the library database) and then click `Next`.
 
 <Screenshot url="https://www.mongodb.com/products/tools/relational-migrator" src="img/70-image-001.png" alt="Screenshot of the connect modal" />
+
+:::tip
+In a real project, you can select just a handful tables in case you're not interested in the whole database.
+:::

docs/50-create-project/80-define-initial-schema.mdx

@@ -2,8 +2,7 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 Define the Initial Schema
 
-Relational Migrator gives you three options on how your MongoDB schema should be created. Regardless of which option you choose,
-you can manually modify your schema later. 
+Relational Migrator gives you three options on how your MongoDB schema should be created. Regardless of which option you choose, you can manually modify your schema later. 
 
 Select `Start with a recommended MongoDB schema`
 
@@ -21,4 +20,6 @@ Any tables you did not check will be embedded in other collections.
 
 <Screenshot url="https://www.mongodb.com/products/tools/relational-migrator" src="img/80-image-001.png" alt="Screenshot of the connect modal" />
 
+Select the casing you'd like for your collections. Defaults to camelCase.
+
 Click `Next`, then give your project a name.