Improved setup instructions:

- removed message about CODE_BLOCKS as they're not pertinent to this page
- Added new instructions to get the org id
- reviewed the overall flow

Author: dfreniche

docs/setup/index.mdx

@@ -1,42 +1,46 @@
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
 ---
 sidebar_position: 2
 ---
 
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+
 # 👐 Initial Setup and Access for Atlas CLI
 
-**Run this section in your notebook**
+This section will cover the required notebook operations that must be fulfilled to run the challenges.
 
-:::info
- You can clone our template or use it in one of the online environments: https://github.com/mongodb-developer/security-lab-notebooks/blob/main/template_notebook.ipynb
+## Open the template notebook
 
 :::tip
- **Important! Each piece of code that needs to be edited is marked with `<CODE_BLOCK>`.**
+We recommend using one of the online environments below to run Jupyter Notebooks. 
 :::
 
-[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/security-lab-notebooks/blob/main/template_notebook.ipynb)
+| Google Colab      | GitHub Codespaces    | Clone locally |
+| :------------- | :---------- |  :---------- |
+| [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/security-lab-notebooks/blob/main/template_notebook.ipynb) | [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=mongodb-developer/security-lab-notebooks) | [Template notebook](https://github.com/mongodb-developer/security-lab-notebooks/blob/main/template_notebook.ipynb)|
 
-[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=mongodb-developer/security-lab-notebooks)
 
-This section will cover the required notebook operations that must be fulfilled to run the challenges.
 
-### 1. Install Atlas CLI on the notebook environment.
+## 1. Install Atlas CLI on the notebook environment.
+
+Run the 1st cell in the notebook to install the [Atlas CLI](https://www.mongodb.com/docs/atlas/atlas-cli/), a command line interface to manage MongoDB clusters. 
 
-Run the 1st cell in the notebook to install the Atlas CLI. If you're running the notebook in a Codespace you'll be prompted to install a Python environment and Jupyter Notebooks support. Select the Python Kernel when prompted.
+:::note
+If you're running the notebook in a Codespace you'll be prompted to install two suggested extensions: a Python environment and Jupyter Notebooks support. Install them. When finsished, select the Python environment when prompted.
+:::
 
 ```python
 # Install atlas-cli
 
-!wget https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.37.0_linux_x86_64.deb
-!dpkg -i mongodb-atlas-cli_1.37.0_linux_x86_64.deb
+!wget https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.46.3_linux_x86_64.deb
+!sudo dpkg -i mongodb-atlas-cli_1.46.3_linux_x86_64.deb
 
 # If you require sudo privilege, run the following instead:
-# !sudo dpkg -i mongodb-atlas-cli_1.37.0_linux_x86_64.deb
+# !sudo dpkg -i mongodb-atlas-cli_1.46.3_linux_x86_64.deb
 ```
 
-### 2. Authenticate the CLI against your Atlas organization.
+## 2. Authenticate the CLI against your Atlas organization.
 
 `atlas auth login` typically enters interactive mode. 
 We are piping a new line character so that it selects a default organization for you. 
@@ -86,16 +90,39 @@ Successfully logged in as [email protected].
 ```
 
 
+
+
+</details>
+:::
+
+### 2.1 Get the organization ID
+
+If you are a member of more than one Atlas organization, after login in you'll see a list of your organizations and you can select the one you prefer to run the lab. But if you're using a free account you only have one organization, and the list won't appear.
+
+
+<Tabs groupId="orgId">
+<TabItem value="moreThanOne" label="You have more than one organization">
+
 Take a note of the relevant Organization ID for next steps and "STOP" the cell.
 
 <img src="../img/SuccessPhase.png" />
 
-Take a note of the relevant Organization ID for next step.
 
-</details>
-:::
+</TabItem>
+
+<TabItem value="justOne" label="You have only one organization (free accounts most likely)">
 
-### 3. Create a new project called "MySecureProj."
+You won't see any organization id in the response. Run the 2.1 Cell `Get Organization ID` and copy the `Organization ID`.
+
+```
+ID                         NAME
+31415926535                My Org's Name
+```
+
+</TabItem>
+</Tabs>
+
+## 3. Create a new project called "MySecureProj."
 Replace `<ORGANIZATION_ID>` with the Organization ID from the previous step.
 ```
 # Retain the quotes ("") when pasting the Organization ID
@@ -105,8 +132,11 @@ org_id = "<ORGANIZATION_ID>"
 There should be an output which shows the Project ID of the project created. Use this Project ID for the next step.
 
 
-### 4. Create your challenge cluster.
+## 4. Create your challenge cluster.
 Replace `<PROJECT_ID>` with the Project ID from the previous step.
+
+This will provision an M0, free forever cluster, running in AWS in region US_EAST_1. That cluster will be associated to the project we just created.
+
 ```python
 # Retain the quotes ("") when pasting the Project ID
 project_id = "<PROJECT_ID>"