marcusberr
diff --git a/‎intro.ipynb
Copy file name to clipboardExpand all lines: intro.ipynb
+40-87Lines changed: 40 additions & 87 deletions b/‎intro.ipynb
Copy file name to clipboardExpand all lines: intro.ipynb
+40-87Lines changed: 40 additions & 87 deletions
@@ -1,34 +1,15 @@
 {
  "cells": [
-  {
-   "cell_type": "raw",
-   "metadata": {},
-   "source": [
-    "---\n",
-    "title: \"Python Tutorial 2023\"\n",
-    "subtitle: \"17-20 April\"\n",
-    "format: revealjs\n",
-    "callout-icon: false\n",
-    "jupyter: python3\n",
-    "highlight-style: gruvbox\n",
-    "execute:\n",
-    "    echo: true\n",
-    "    enabled: false\n",
-    "---"
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Welcome! 🐍\n",
+    "# Welcome! 🐍\n",
     "\n",
     "Hello and welcome, everyone! We’re excited that you chose to embark in this Python journey\n",
     "\n",
     "Over **four** days, we'll see a lot of Python. **Two** fundamental topics each day\n",
     "\n",
-    "::: {.panel-tabset}\n",
-    "\n",
     "### Day 1\n",
     "1. Basic syntax and data types\n",
     "2. Control flow, loops, and exceptions\n",
@@ -45,14 +26,7 @@
     "1. Modules and packages\n",
     "2. Questions, exercises, more questions...\n",
     "\n",
-    ":::\n",
-    "\n",
-    "\n",
-    "::: {.notes}\n",
-    "\n",
-    "Although this is an introductory course, we will be going quite in-depth to cover as much ground as possible. Our aim is to equip you with a strong foundation in Python programming that you can build on in the future. So, let's get started!\n",
-    "\n",
-    ":::"
+    "Although this is an introductory course, we will be going quite in-depth to cover as much ground as possible. Our aim is to equip you with a strong foundation in Python programming that you can build on in the future. So, let's get started!"
    ]
   },
   {
@@ -63,18 +37,13 @@
     "\n",
     "**TL;DR:** Every morning, 9:00-13:00, on Zoom\n",
     "\n",
-    ". . .\n",
-    "\n",
     "More in detail:\n",
     "\n",
-    "::: {.incremental}\n",
-    "\n",
     "- 8:45-9:00 — Welcome, warm-up questions\n",
     "- 9:00-10:50 — Topic 1 (theory, hands-on, Q&A)\n",
-    "- *10:50-11:10 — Break ☕*\n",
+    "- *10:50-11:10 — Break* ☕\n",
     "- 11:10-13:00 — Topic 2\n",
-    "\n",
-    ":::"
+    "- 🥪 – Practice – Offline discussions on Slack"
    ]
   },
   {
@@ -83,16 +52,10 @@
    "source": [
     "## How to interact\n",
     "\n",
-    "::: {.notes}\n",
-    "\n",
     "Each block is 20% theory and 80% hands-on. It's an online workshop, so interaction between us is **essential**\n",
     "\n",
-    ":::\n",
-    "\n",
     "A few tips to interact:\n",
     "\n",
-    "::: {.panel-tabset}\n",
-    "\n",
     "### On Zoom\n",
     "- Raise your hand 🤚 then ask\n",
     "- Write in the chat\n",
@@ -101,16 +64,10 @@
     "\n",
     "### On Slack\n",
     "- Ask your question in the **corresponding channel**. Use `#help` for generic questions\n",
-    "- Reply **in a thread** if you want to add a comment on another question\n",
+    "- Reply **in a thread** if you want to add a comment to a question\n",
     "- Use `@Sasha`, `@Simone`, `@Edoardo` if you want to mention the tutorial instructors directly\n",
     "\n",
-    ":::\n",
-    "\n",
-    "::: {.notes}\n",
-    "\n",
-    "Although the chat will be distributed together with the recording, Slack is much better suited to hold continued Q&A and other discussions. Please, use it.\n",
-    "\n",
-    ":::"
+    "Although the chat will be distributed together with the recording, Slack is much better suited to hold continued Q&A and other discussions. Please, use it."
    ]
   },
   {
@@ -134,17 +91,11 @@
    "source": [
     "## Exercises 🌶️\n",
     "\n",
-    "::: {.fragment}\n",
-    "\n",
     "For each topic we prepared a bunch of exercises to practice the concepts\n",
     "\n",
-    ":::\n",
+    "In the notebooks, you will see cells like\n",
     "\n",
-    "::: {.fragment}\n",
-    "\n",
-    "You will see cells like\n",
-    "\n",
-    "```{.python code-line-numbers=\"false\"}\n",
+    "```python\n",
     "%%ipytest\n",
     "\n",
     "def solution_to_exercise(input_arg):\n",
@@ -156,54 +107,56 @@
     "\n",
     "**Unless otherwise noted**, you can delete everything *below* the line starting with `def` and write your solution\n",
     "\n",
-    ":::\n",
-    "\n",
-    "::: {.notes}\n",
-    "\n",
     "The \"chili\" 🌶️ symbol estimates the effort required. In general, more chilis mean more work and thinking to solve the exercise\n",
     "\n",
     "Double-check before deleting everything in a solution's cell. There might be useful hints to solve the exercise!\n",
     "\n",
-    ":::"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## Exercises 🌶️\n",
+    "---\n",
     "\n",
-    "::: {.callout-important}\n",
+    "Let's look at one important detail about exercises: the variables in **your solution** you are expected to work with.\n",
     "\n",
-    "If you tried to evaluate an exercise cell and you see the error\n",
+    "```python\n",
+    "%%ipytest\n",
     "\n",
+    "def solution_longest_sequence(numbers: list[int]) -> int:\n",
+    "    \"\"\"\n",
+    "    You should treat `numbers` as a \"list of integers\".\n",
+    "    It will be already defined when you run this function\n",
+    "    \"\"\"\n",
+    "    pass\n",
     "```\n",
-    "UsageError: Cell magic %%ipytest not found\n",
-    "```\n",
-    "\n",
-    "make sure you **first** evaluate the cell with the content below\n",
     "\n",
-    "```\n",
-    "%reload_ext tutorial.tests.testsuite\n",
-    "```\n",
+    "<div class=\"alert alert-block alert-danger\">\n",
+    "    <h4><b>Important</b></h4>\n",
+    "    The input arguments to the <code>solution_*</code> function <strong>is already available</strong>. We also tell you what <strong>type</strong> you should expect: a string, an integer, a file path, or anything else.\n",
+    "</div> \n",
     "\n",
-    "You should find it just after the **Exercises** section heading\n",
     "\n",
-    ":::\n",
+    "Remember: **ask** if you need help, either on Zoom or on Slack. These four days should be a practical workshop where we can answer to most of your questions you have as a beginner Python user. Let's make the most out of this time!\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Hands-on sessions\n",
     "\n",
-    ". . .\n",
+    "There will be plenty of time to work on the exercises.\n",
     "\n",
-    "::: {.callout-tip}\n",
+    "Here's how these time slots will be organized **on Zoom**:\n",
     "\n",
-    "There might be more exercises than time available. Don't worry, you can come back and continue any time, even after the workshop\n",
+    "### Main room\n",
     "\n",
-    ":::\n",
+    "- Anyone who is not yet comfortable with Python\n",
+    "- Walkthrough of a few challenging exercises\n",
+    "- **Interactive**: you should participate with suggestions\n",
     "\n",
-    "::: {.notes}\n",
     "\n",
-    "Remember: **ask** if you need help, either on Zoom or on Slack. These four days should be a practical workshop where we can answer to most of your questions you have as a beginner Python user. Let's make the most out of this time!\n",
+    "### Break-out rooms\n",
     "\n",
-    ":::"
+    "- Anyone who wants to work on their own\n",
+    "- Discussion with someone who wants to share their code\n",
+    "- Specific Q&A"
    ]
   },
   {