From 32014d8473ad5d2f15c479631dc6583d705b0068 Mon Sep 17 00:00:00 2001 From: Duabo Albert Bobmanuel Date: Tue, 3 Mar 2026 09:09:38 +0100 Subject: [PATCH 1/3] add learning outcomes + dataset note + setup troubleshooting --- README.md | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 4e58b3c..4451a9a 100644 --- a/README.md +++ b/README.md @@ -7,16 +7,20 @@ **Duration**: ~3 hours --- - -## 🎯 What You'll Learn - -By the end of this course, you'll be able to: - -- Write Python code for data analysis -- Load and manipulate data with Polars -- Create interactive visualizations with Plotly -- Use AI tools (GitHub Copilot) to help you code - +## What you'll learn (by the end of this class) +- Load and explore a dataset with Python +- Perform basic data cleaning and transformations with Polars +- Create simple visualizations with Plotly +- Use GitHub Copilot responsibly to speed up learning + +## Dataset note +The datasets in this repository are provided for learning purposes. + +## Common setup issues (quick fixes) +- **`uv` command not found**: close and reopen your terminal after installing UV (or restart VS Code). +- **Install/Sync fails**: run `uv sync` again from the project folder (where `pyproject.toml` is). +- **Marimo won't start / port in use**: stop other running notebooks/apps, then rerun the start command. +- **Permission issues on Windows**: try running PowerShell as Administrator. --- ## 🚀 Quick Start (5 Minutes) From 61307d95c4ec81ef5b4799d0cfef4dec464528f3 Mon Sep 17 00:00:00 2001 From: Duabo Albert Bobmanuel Date: Tue, 3 Mar 2026 09:25:43 +0100 Subject: [PATCH 2/3] spec: align Python version and dependencies with pyproject --- spec.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec.md b/spec.md index 357bd7c..53c965a 100644 --- a/spec.md +++ b/spec.md @@ -92,7 +92,7 @@ IntroDataScience/ **Contains**: - Project metadata (name, version, description) -- Python version requirement (3.11+) +- Python version requirement (3.12+) - Dependencies: `marimo`, `polars`, `plotly`, `jupyter` (for compatibility) - Dev dependencies: `ruff` (linting), `pytest` (testing) - UV-specific configuration settings From 4e4f8d2561c8e1f9524562737a6de7a1399b391f Mon Sep 17 00:00:00 2001 From: Duabo Albert Bobmanuel Date: Tue, 3 Mar 2026 09:49:31 +0100 Subject: [PATCH 3/3] spec: fully align dependencies and Python version with pyproject --- spec.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/spec.md b/spec.md index 53c965a..f6c76f7 100644 --- a/spec.md +++ b/spec.md @@ -93,14 +93,14 @@ IntroDataScience/ - Project metadata (name, version, description) - Python version requirement (3.12+) -- Dependencies: `marimo`, `polars`, `plotly`, `jupyter` (for compatibility) -- Dev dependencies: `ruff` (linting), `pytest` (testing) +- Dependencies: `marimo`, `polars`, `plotly +- Dev dependencies: none currently defined - UV-specific configuration settings #### `.python-version` -**Purpose**: Specify Python version for UV -**Content**: `3.11` or `3.12` +**Content**: `3.12` +Note: This project requires Python 3.12 or higher as defined in `pyproject.toml` #### `.gitignore`