Merge pull request #35 from mongodb-developer/feature/DA-7297

Add/clarify info to help with common connection sssues

Author: nestor-daza-mdb

docs/10-intro.mdx

@@ -5,7 +5,7 @@ sidebar_position: 10
 
 |Workshop goals|Get your environment ready for other hands-on labs|
 |-|-|
-|Prerequisites|A web browser - See [Requirements](#minimum-hardware-requirements)|
+|Prerequisites|A web browser - See [Requirements](#requirements)|
 |Time to complete|10-15 minutes|
 
 These labs are meant to be presented by one of our amazing instructors, but you can also do them on your own.
@@ -18,45 +18,44 @@ In the navigation bar, you will notice some icons. Here are their meanings:
 |👐|Hands-on content - Get ready to get some work done. You should follow these steps.|
 |🦸|Advanced content - This content isn't covered during the lab, but you can check it out if you're interested in learning more.|
 |ℹ️|Troubleshooting information - This content is designed to help you resolve common problems. |
-# Requirements
 
-To ensure you have the best experience during our sessions, please review the following minimum hardware requirements needed to participate effectively in our workshops and activities. These requirements are essential for running modern browsers and cloud-based applications involved in our sessions.
+## Requirements
+
+* Google Chrome installed
+* GitHub account
+* Ensure your laptop can access GitHub and GitHub Codespaces (sometimes corporate VPNs block these sites!)
+
+## Hardware requirements
 
-## Minimum hardware requirements:
+To ensure you have the best experience during our sessions, please review the following minimum hardware requirements needed to participate effectively in our workshops and activities. These requirements are essential for running modern browsers and cloud-based applications involved in our sessions.
 
-### Operating system:
+### Operating system
 
 - Windows: Windows 10 (version 1903 or later)
 
 - macOS: macOS Catalina (10.15) or later
 
-### Processor:
+### Processor
 
 - Intel: Core i5 or better
 - AMD: Ryzen 5 or equivalent
 - Apple Silicon: M1 chip or later
 
-### Memory:
+### Memory
 - Minimum RAM: 8 GB
 - Recommended RAM: 16 GB or more for smoother multitasking and more demanding applications
 
-### Storage:
+### Storage
 
 - At least 256 GB of available space, preferably SSD, for faster read/write speeds
 
-### Internet connection:
+### Internet connection
 
 - Stable and high-speed internet connection (minimum 15 Mbps) for optimal performance with cloud-based applications
 
-## Recommendations:
+## Recommendations
 
 - Ensure that your system software is up to date to benefit from the latest features and security enhancements.
 - Consider using a monitor with at least 1080p resolution for a clearer and more detailed visual experience during our presentations and hands-on sessions.
 
-## Other requirements:
-
-* Google Chrome installed
-* GitHub account
-* Ensure your laptop can access GitHub and GitHub Codespaces
-
 By meeting these hardware specifications, you will be well-prepared to engage fully with our Developer Day content. We look forward to an exciting and productive event with all participants!

docs/20-mongodb-atlas/2-create-account.mdx

@@ -3,7 +3,29 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 Create Your Account
 
-To use MongoDB Atlas, start by creating an account. If you already have an account, you can skip this step.
+To use MongoDB Atlas, start by creating an account.
+
+<details>
+  <summary>🦸‍♀️ If you already have an Atlas account, you can use it by creating a new project</summary>
+  
+    First, log into <Link to="https://account.mongodb.com/">MongoDB Atlas</Link> using your existing credentials.
+
+    <Screenshot url="https://account.mongodb.com" src={"img/screenshots/20-mongodb-atlas/2-create-account/3-login.png"} alt="Login form" />
+
+    ## Create a new Atlas project
+
+    Once you're in Atlas, open the dropdown on the left-top corner of the page and select **New Project**.
+
+    <Screenshot url="https://cloud.mongodb.com" src={"img/screenshots/20-mongodb-atlas/2-create-account/4-new-project.png"} alt="Create new project" />
+
+    Enter a name for your project and click **Next**.
+
+    <Screenshot url="https://cloud.mongodb.com" src={"img/screenshots/20-mongodb-atlas/2-create-account/5-new-project-name.png"} alt="Create new project" />
+
+    On the next page, you can leave the current user as the project owner, and click **Create Project**.
+
+    Once the project is ready, continue the workshop <a href="./create-cluster">**deploying a Database Cluster**</a>
+</details>
 
 ## Sign up for MongoDB Atlas
 

docs/20-mongodb-atlas/3-create-cluster.mdx

@@ -36,7 +36,11 @@ While your deployment is being provisioned, you will see the security quickstart
 
 ### Network access
 
-First, you should **Allow Access from Anywhere**. You will see a field prepopulated with the IP address `0.0.0.0/0`. This means that you can connect to your database from any IP address, including the virtual environment you will use for this lab. Click "Add IP Address" to add this IP address to the network allowlist.
+First, you need to **Allow Access from Anywhere**. You will see a field prepopulated with the IP address `0.0.0.0/0`. This means that you can connect to your database from any IP address, including the virtual environment you will use for this lab. Click **Add IP Address** to add it to the network allowlist.
+
+:::note
+If you don't see a button to allow access from anywhere, you should close the dialog and go to the **Network Access** tab under the **Security** section in the left sidebar. Click on **Add IP Address**, add `0.0.0.0/0`, and click **Confirm**.
+:::
 
 :::caution
 It is dangerous to expose your database to the entire world. Never do this in a real production environment.
@@ -53,13 +57,9 @@ Make sure to remember your username and password. You will need them later.
 
 For the sake of this workshop, it might be preferable to use a simple password that you'll remember over a more secure one.
 
-Don't use any special characters in your password. Even though MongoDB allows some special characters, they might not work well with the tools you'll use later in this workshop.
+<strong>Don't use any special characters in your password</strong>. Even though MongoDB allows some special characters, they might not work well with the tools you'll use later in this workshop.
 :::
 
-### Manual network access configuration
-
-If you don't see a button to allow access from anywhere, you should close the dialog and go to the **Network Access** tab under the **Security** section in the left sidebar. Click on "Add IP Address," add the IP address `0.0.0.0/0`, and click "Confirm."
-
 ## That's all!
 
 You have a new database cluster, and you can now connect to it from your application. If everything goes well, you should see your newly created cluster in the database deployment screen.

docusaurus.config.js

@@ -3,7 +3,7 @@
 
 // Change here to customise config
 
-// Name of the Github Repo, it's also teh baseUrl
+// Name of the Github Repo, it's also the baseUrl
 const workshopName = 'intro-lab';
 // Change this if hosting outside mongodb-developer
 const organizationName = "mongodb-developer";