diff --git a/tutorials/building-comfort/README.md b/tutorials/building-comfort/README.md index c0288f0..e681506 100644 --- a/tutorials/building-comfort/README.md +++ b/tutorials/building-comfort/README.md @@ -32,9 +32,21 @@ The easiest way to follow this tutorial is the **dev container**, which installs ### Option A: Dev Container or GitHub Codespaces (recommended) -1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code and run **Reopen in Container** (or create a **Codespace** from the repo's **Code** menu). -2. When prompted for a configuration, choose **Building Comfort Tutorial (Python)**. -3. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies (`drasi-lib`, `streamlit`, `psycopg`) and the Docker tooling for PostgreSQL. +**VS Code (local dev container)** + +1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code. +2. Run **Dev Containers: Reopen in Container**. +3. When prompted for a configuration, choose **Building Comfort Tutorial (Python)**. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies (`drasi-lib`, `streamlit`, `psycopg`) and the Docker tooling for PostgreSQL. + +**GitHub Codespaces** + +The default **Create codespace** button does not ask which configuration to use. Pick the tutorial config explicitly: + +1. On the [`drasi-python`](https://github.com/drasi-project/drasi-python) repo page, open the green **Code** menu and select the **Codespaces** tab. +2. Open the `...` menu next to **Create codespace on ...** and choose **New with options…**. +3. Under **Dev container configuration**, select **Building Comfort Tutorial (Python)**, then create the codespace. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies (`drasi-lib`, `streamlit`, `psycopg`) and the Docker tooling for PostgreSQL. That's it — skip ahead to [Step 2](#step-2-of-4-run-the-demo). diff --git a/tutorials/building-comfort/_index.md b/tutorials/building-comfort/_index.md index a70d4aa..9e10c92 100644 --- a/tutorials/building-comfort/_index.md +++ b/tutorials/building-comfort/_index.md @@ -68,9 +68,21 @@ The easiest way to follow this tutorial is the **dev container**, which installs ### Option A: Dev Container or GitHub Codespaces (recommended) -1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code and run **Reopen in Container** (or create a **Codespace** from the repo's **Code** menu). -2. When prompted for a configuration, choose **Building Comfort Tutorial (Python)**. -3. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies (`drasi-lib`, `streamlit`, `psycopg`) and the Docker tooling for PostgreSQL. +**VS Code (local dev container)** + +1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code. +2. Run **Dev Containers: Reopen in Container**. +3. When prompted for a configuration, choose **Building Comfort Tutorial (Python)**. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies (`drasi-lib`, `streamlit`, `psycopg`) and the Docker tooling for PostgreSQL. + +**GitHub Codespaces** + +The default **Create codespace** button does not ask which configuration to use. Pick the tutorial config explicitly: + +1. On the [`drasi-python`](https://github.com/drasi-project/drasi-python) repo page, open the green **Code** menu and select the **Codespaces** tab. +2. Open the `...` menu next to **Create codespace on ...** and choose **New with options…**. +3. Under **Dev container configuration**, select **Building Comfort Tutorial (Python)**, then create the codespace. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies (`drasi-lib`, `streamlit`, `psycopg`) and the Docker tooling for PostgreSQL. That's it — skip ahead to [Step 2](#run). diff --git a/tutorials/curbside-pickup/README.md b/tutorials/curbside-pickup/README.md index 4759d12..c5c3c71 100644 --- a/tutorials/curbside-pickup/README.md +++ b/tutorials/curbside-pickup/README.md @@ -37,9 +37,21 @@ This tutorial needs **Docker** (it runs PostgreSQL and MySQL) and **Python 3.10+ ### Option A: Dev Container or GitHub Codespaces (recommended) -1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code and run **Reopen in Container** (or create a **Codespace** from the repo's **Code** menu). -2. When prompted for a configuration, choose **Curbside Pickup Tutorial (Python)**. -3. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies and the Docker tooling for the two databases. +**VS Code (local dev container)** + +1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code. +2. Run **Dev Containers: Reopen in Container**. +3. When prompted for a configuration, choose **Curbside Pickup Tutorial (Python)**. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies and the Docker tooling for the two databases. + +**GitHub Codespaces** + +The default **Create codespace** button does not ask which configuration to use. Pick the tutorial config explicitly: + +1. On the [`drasi-python`](https://github.com/drasi-project/drasi-python) repo page, open the green **Code** menu and select the **Codespaces** tab. +2. Open the `...` menu next to **Create codespace on ...** and choose **New with options…**. +3. Under **Dev container configuration**, select **Curbside Pickup Tutorial (Python)**, then create the codespace. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies and the Docker tooling for the two databases. That's it. Skip ahead to [Step 2](#step-2-of-4-run-the-demo). diff --git a/tutorials/curbside-pickup/_index.md b/tutorials/curbside-pickup/_index.md index 9207e3a..f3a0f6d 100644 --- a/tutorials/curbside-pickup/_index.md +++ b/tutorials/curbside-pickup/_index.md @@ -73,9 +73,21 @@ This tutorial needs **Docker** (it runs PostgreSQL and MySQL) and **Python 3.10+ ### Option A: Dev Container or GitHub Codespaces (recommended) -1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code and run **Reopen in Container** (or create a **Codespace** from the repo's **Code** menu). -2. When prompted for a configuration, choose **Curbside Pickup Tutorial (Python)**. -3. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies and the Docker tooling for the two databases. +**VS Code (local dev container)** + +1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code. +2. Run **Dev Containers: Reopen in Container**. +3. When prompted for a configuration, choose **Curbside Pickup Tutorial (Python)**. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies and the Docker tooling for the two databases. + +**GitHub Codespaces** + +The default **Create codespace** button does not ask which configuration to use. Pick the tutorial config explicitly: + +1. On the [`drasi-python`](https://github.com/drasi-project/drasi-python) repo page, open the green **Code** menu and select the **Codespaces** tab. +2. Open the `...` menu next to **Create codespace on ...** and choose **New with options…**. +3. Under **Dev container configuration**, select **Curbside Pickup Tutorial (Python)**, then create the codespace. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependencies and the Docker tooling for the two databases. That's it. Skip ahead to [Step 2](#run). diff --git a/tutorials/getting-started/README.md b/tutorials/getting-started/README.md index 23a5376..18169ad 100644 --- a/tutorials/getting-started/README.md +++ b/tutorials/getting-started/README.md @@ -30,9 +30,21 @@ This tutorial needs **Python 3.10+** and **Docker** (for PostgreSQL). The easies ### Option A: Dev Container or GitHub Codespaces (recommended) -1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code and run **Reopen in Container** (or create a **Codespace** from the repo's **Code** menu). -2. When prompted for a configuration, choose **Getting Started Tutorial (Python)**. -3. Wait for the container to finish. Its setup script installs the tutorial's Python dependency (`drasi-lib`) and the Docker tooling for PostgreSQL. +**VS Code (local dev container)** + +1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code. +2. Run **Dev Containers: Reopen in Container**. +3. When prompted for a configuration, choose **Getting Started Tutorial (Python)**. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependency (`drasi-lib`) and the Docker tooling for PostgreSQL. + +**GitHub Codespaces** + +The default **Create codespace** button does not ask which configuration to use. Pick the tutorial config explicitly: + +1. On the [`drasi-python`](https://github.com/drasi-project/drasi-python) repo page, open the green **Code** menu and select the **Codespaces** tab. +2. Open the `...` menu next to **Create codespace on ...** and choose **New with options…**. +3. Under **Dev container configuration**, select **Getting Started Tutorial (Python)**, then create the codespace. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependency (`drasi-lib`) and the Docker tooling for PostgreSQL. That's it. Skip ahead to [Step 2](#step-2-of-4-run-the-demo). diff --git a/tutorials/getting-started/_index.md b/tutorials/getting-started/_index.md index 9b2b52b..b5c8c40 100644 --- a/tutorials/getting-started/_index.md +++ b/tutorials/getting-started/_index.md @@ -66,9 +66,21 @@ This tutorial needs **Python 3.10+** and **Docker** (for PostgreSQL). The easies ### Option A: Dev Container or GitHub Codespaces (recommended) -1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code and run **Reopen in Container** (or create a **Codespace** from the repo's **Code** menu). -2. When prompted for a configuration, choose **Getting Started Tutorial (Python)**. -3. Wait for the container to finish. Its setup script installs the tutorial's Python dependency (`drasi-lib`) and the Docker tooling for PostgreSQL. +**VS Code (local dev container)** + +1. Open the [`drasi-python`](https://github.com/drasi-project/drasi-python) repository in VS Code. +2. Run **Dev Containers: Reopen in Container**. +3. When prompted for a configuration, choose **Getting Started Tutorial (Python)**. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependency (`drasi-lib`) and the Docker tooling for PostgreSQL. + +**GitHub Codespaces** + +The default **Create codespace** button does not ask which configuration to use. Pick the tutorial config explicitly: + +1. On the [`drasi-python`](https://github.com/drasi-project/drasi-python) repo page, open the green **Code** menu and select the **Codespaces** tab. +2. Open the `...` menu next to **Create codespace on ...** and choose **New with options…**. +3. Under **Dev container configuration**, select **Getting Started Tutorial (Python)**, then create the codespace. +4. Wait for the container to finish. Its setup script installs the tutorial's Python dependency (`drasi-lib`) and the Docker tooling for PostgreSQL. That's it. Skip ahead to [Step 2](#run).