Skip to content

Commit 76c0d05

Browse files
docs: require own-repo-first setup flow before local or codespaces
Co-authored-by: jamesmontemagno <1676321+jamesmontemagno@users.noreply.github.com>
1 parent b904748 commit 76c0d05

3 files changed

Lines changed: 19 additions & 17 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ uv sync
3636
This repository includes a preconfigured devcontainer at `.devcontainer/devcontainer.json`.
3737

3838
- **Local VS Code**: Reopen the repo in container when prompted
39-
- **GitHub Codespaces**: Click **Code****Codespaces****Create codespace on main**
39+
- **GitHub Codespaces**: In your own repository created from this template, click **Code****Codespaces****Create codespace on main**
4040

4141
## Run
4242

workshop/01-setup.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,38 +12,38 @@ In this section, you'll set up your development environment and teach GitHub Cop
1212

1313
## 🔧 Initial Setup
1414

15-
### Step 1: Choose Your Start Option
16-
17-
This repo already includes a ready-to-use devcontainer (`.devcontainer/devcontainer.json`), so you can run locally or in Codespaces.
18-
19-
#### Option A: Create Your Own Repository (best if you want your own GitHub Pages URL)
15+
### Step 1: Create Your Own Repository (required)
2016

2117
1. Open [github.com/copilot-dev-days/agent-lab-python](https://github.com/copilot-dev-days/agent-lab-python)
2218
2. Click **Use this template****Create a new repository**
2319
- Name: `my-soc-ops-python`
2420
- Visibility: **Public**
2521
3. ✅ Your own Soc Ops repo is ready!
2622

27-
#### Option B: Open in GitHub Codespaces (no template/fork needed)
28-
29-
1. Open [github.com/copilot-dev-days/agent-lab-python](https://github.com/copilot-dev-days/agent-lab-python)
30-
2. Click **Code****Codespaces****Create codespace on main**
31-
3. Wait for setup to finish (the devcontainer runs `uv sync` automatically)
32-
4. ✅ You can start the lab directly in the browser-based VS Code experience
33-
34-
### Step 2: Enable GitHub Pages (Option A only)
23+
### Step 2: Enable GitHub Pages
3524

3625
1. Go to your repo's **Settings****Pages**
3726
2. Under "Build and deployment", select **GitHub Actions**
3827
3. ✅ Every commit will now publish to: `https://{username}.github.io/{repo-name}`
3928

40-
### Step 3: Clone & Open in VS Code (Option A only)
29+
### Step 3: Choose How to Open Your Repository
30+
31+
This repo includes a ready-to-use devcontainer (`.devcontainer/devcontainer.json`), so you can work locally or in Codespaces.
32+
33+
#### Option A: Clone & Open in Local VS Code
4134

4235
1. Open VS Code
4336
2. Run command: `Git: Clone``Clone from GitHub`
4437
3. Select your new repository
4538
4. When prompted, install **recommended extensions**
4639

40+
#### Option B: Open Your New Repo in GitHub Codespaces
41+
42+
1. Open your newly created repository on GitHub
43+
2. Click **Code****Codespaces****Create codespace on main**
44+
3. Wait for setup to finish (the devcontainer runs `uv sync` automatically)
45+
4. ✅ You can start the lab directly in the browser-based VS Code experience
46+
4747
### Step 4: Run the Setup Agent (both options)
4848

4949
In the Chat panel:

workshop/GUIDE.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,10 @@
3232
## 🚀 Quick Setup
3333

3434
```
35-
# Option A (Codespaces): Code > Codespaces > Create codespace on main
36-
# Option B (own repo): Use template, enable GitHub Pages, then clone in VS Code
35+
# Step 1: Use template to create your own repo
36+
# Step 2: Enable GitHub Pages in your new repo
37+
# Step 3a (local): Clone your repo in VS Code
38+
# Step 3b (cloud): Open your repo in Codespaces (Code > Codespaces > Create codespace on main)
3739
# Then run /setup in Chat
3840
```
3941

0 commit comments

Comments
 (0)