Austin Feedback fixes

Author: dfreniche

docs/10-intro.mdx

@@ -14,7 +14,7 @@ import TabItem from '@theme/TabItem';
 ||- Map the relational schema to a MongoDB schema|
 ||- Migrate the data to MongoDB|
 |Prerequisites| See [Prerequisites](/docs/category/-prerequisites/)|
-|Time to complete|1 hour|
+|Time to complete|1.5 hour|
 
 These labs are meant to be presented by one of our amazing instructors, but you can also do them on your own.
 

docs/210-Generate code/10-generate-app-code.mdx

@@ -5,10 +5,15 @@ import Screenshot from "@site/src/components/Screenshot";
 The Relational Migrator allows you to generate application code in a variety of languages, derived from your MongoDB schema definition.
 While this code is not a full-blown app, it can save developers significant time compared to creating entity classes by hand. 
 
+## Generate model classes for your collections
+
 - At the top, switch to Code Generation tab
 - Under Language, select `C#` (or your preferred language)
 - Under Template, select `Persistence Layer`
 - Click each of the collections in the list. Notice the tabs containing entity classes and CRUD helpers for each collection or embedded object.
+
+## Generate JSON Schema files
+
 - Under Language, select `JSON'
 - Under Template, select `Sample Documents`. Notice how you can view examples of how data in each collection will be structured.
 - Under Template, select `JSON Schema (MongoDB)`. Notice how you can view and download JSON [Schema validators](https://mongodb-developer.github.io/intro-lab/docs/category/schema-validation) which could be used to enforce schema compliance.

docs/210-Generate code/20-convert-queries.mdx

@@ -10,7 +10,10 @@ in your choice of programming langauge. This feature uses Artifical Intelligence
 - Sign into your MongoDB Atlas account
 - Accept the Query Converter licence terms
 - Click `Paste SQL query`
-- In the empty query, type `SELECT * FROM books WHERE "bookOfTheMonth" = true AND pages > 500` 
+- In the empty query, type 
+```sql
+SELECT * FROM library.books WHERE "bookOfTheMonth" = true AND pages > 500
+```
 - Leave the language as JavaScript and click Convert. 
 
 After a while, the equivalent MongoDB query will be shown at the right of the page. 

docs/220-Migrate Data/10-migration.mdx

@@ -2,29 +2,46 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 Run a Snapshot Migration Job
 
-- At the top, switch to Data Migration tab
+## Data migration tab
 
-<Screenshot url="http://127.0.0.1:8278" src="img/210-image-001.png" alt="Screenshot of the connect modal" />
+- At the top, switch to Data Migration tab.
 
-- Click create sync job
-- Specify source DB connection details
-  - The details will be populated from when you created the project. 
+<Screenshot url="http://127.0.0.1:8278" src="img/210-image-001.png" alt="Screenshot of the migration screen" />
+
+- Click `Create migration job`.
+
+## Source database (PostgreSQL) connection details
+
+- By default your current connection details are shown under `Use a saved connection` or you can enter the connection details manually.
+- `Test connection`.
+- Click on `Connect`.
 
 <Screenshot url="http://127.0.0.1:8278" src="img/210-image-002.png" alt="Screenshot of the connect modal" />
 
+## Target database (MongoDB) connection details
+
 - Specify MongoDB connection details
-  - Enter the URI, database, username and password for your MongoDB cluster
-  - If you are using Atlas, you can retrieve the details from the [Atlas portal](https://cloud.mongodb.com)
+  - Enter the URI, database, username and password for your MongoDB cluster.
+  - If you are using Atlas, you can retrieve the details from the [Atlas portal](https://cloud.mongodb.com).
+  - `Test connection`.
+  - Click on `Connect`.
+
 
 <Screenshot url="http://127.0.0.1:8278" src="img/210-image-003.png" alt="Screenshot of the connect modal" />
 
-- Specify migration options 
-  - Choose the `Drop destination collections before migration` option
+## Specify migration options 
+
+- We will select `Snapshot` as our migration type.
+- Choose the `Drop destination collections before migration` option.
+- Click on `Review summary`.
 
 <Screenshot url="http://127.0.0.1:8278" src="img/210-image-004.png" alt="Screenshot of the connect modal" />
 
+
+## Start the migration
+
 - Read migration summary to confirm details
-- Run Start
+- Click `Start`
 - Monitor the progress of the job
 
 <Screenshot url="http://127.0.0.1:8278" src="img/210-image-005.png" alt="Screenshot of the connect modal" />

docs/220-Migrate Data/20-view-migrated-data.mdx

@@ -2,7 +2,7 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 View Migrated Data
 
-Once the job has finished, you can view it in MongoDB. You can perform this task using the `mongosh` command line tool,
+Once the job has finished, you can view your data in MongoDB. You can perform this task using the `mongosh` command line tool,
 MongoDB Compass, or MongoDB Atlas. This topic assumes you have migrated your data to MongoDB Atlas.
 
 - In a web browser, navigate to the [MongoDB Atlas portal](https://cloud.mongodb.com) and sign in with your account

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

@@ -12,7 +12,7 @@ Ensure the Relational Migrator is installed and running (usually at http://127.0
 <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 database** under "Connect to live database" if you are running the source database in the cloud, Docker or using your own hardware.
+- 👐 Click **Connect database** under "Connect to live database" if you are running the source database in the cloud, Docker or using your own hardware. This is what we will use during an instructor-led hands-on lab.
 - 🦸‍♂️ Click **Import .SQL file** under "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 **Create sample** under "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.
 

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

@@ -18,7 +18,7 @@ Enter the details for the PostgreSQL database you will be migrating from.
 
 - 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 back on the `General` tab and enter the database name as `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

docs/60-project-settings.mdx

@@ -3,13 +3,13 @@ import Screenshot from "@site/src/components/Screenshot";
 # 👐 Project Settings
 
 
-- On the top left, click the settings icon.
+- On the top left, next to the three dots, click the settings ⚙️ icon.
 - Select single inherited primary key. This detects the primary key from the relational schema and sets them as the `_id` in MongoDB.
-- Optionally, toggle Suggested Mappings on and off. 
+- Optionally, toggle Suggested Mappings on and off.
 
 
 :::info
-If we don't do this we'll have both an autogenerated `_id` field of type `ObjectId` and a `id` field copied from the relational DB.
+If we don't do this we'll have both an autogenerated `_id` field of type `ObjectId` and a `id` field copied from the relational DB. Inheriting the id we copy the existing ids over to MongoDB from our relational DB.
 :::
 
 <Screenshot url="http://127.0.0.1:8278" src="img/90-image-001.png" alt="Screenshot of the connect modal" />

docs/70-toggle-view.mdx

@@ -6,5 +6,5 @@ At the bottom left, toggle between different views. We should be looking at the
 
 <Screenshot url="http://127.0.0.1:8278" src="img/100-image-000.png" alt="We can toggle between MDB, relational or both views" />
 
-<Screenshot url="http://127.0.0.1:8278" src="img/100-image-001.png" alt="Screenshot of the connect modal" />
-
+[![Screenshot of the MongoDB ERD](/img/100-image-001.png)](/img/100-image-001.png)
+_Click to enlarge in a new tab / window_

docs/80-edit-mapping-rules/20-edit-mapping-books-book-genre.mdx

@@ -34,7 +34,6 @@ genres: [
 - Click on the edit icon of the `book_genre` embedded array.
 - Change the field name from `bookGenres` to `genres`.
 - Uncheck `bookId` and `genreId`.
-- Change the fieldname from `genre` to `name`
 - Click `Save and close`.