revise ch 1,2,3

Author: fabridamicelli

book/01_getting_started.ipynb book/01_1_getting_started.ipynbbook/01_getting_started.ipynb renamed to book/01_1_getting_started.ipynb

@@ -16,7 +16,7 @@
    "id": "fc45f0ff-5ff8-47ba-a839-f8fdf55c7a9f",
    "metadata": {},
    "source": [
-    "There are several ways to execute code."
+    "There are several ways to execute (also called \"run\") Python code."
    ]
   },
   {
@@ -72,7 +72,7 @@
     "\n",
     "> A read–eval–print loop (REPL) is a simple interactive computer programming environment that takes single user inputs, executes them, and returns the result to the user.\n",
     "\n",
-    "If type `uv run python` in our terminal and hit enter, we get into the built-in python REPL."
+    "If we type `uv run python` in our terminal and hit enter, we get into the built-in python REPL."
    ]
   },
   {
@@ -139,7 +139,7 @@
    "metadata": {},
    "source": [
     "- `?`\n",
-    "- `! <COMMAND>`: Call the system COMMAND, eg `!ls` to list contents.\n",
+    "- `! <COMMAND>`: Call the system COMMAND, eg `!ls` to list contents of current directory.\n",
     "- `%run`: Run a file inside IPython as a program. \n",
     "- `%time`: Time execution of a Python statement or expression.\n",
     "- `%timeit`: Time execution of a Python statement or expression."
@@ -158,7 +158,7 @@
     "3) Multiply 3 twenty two times\n",
     "4) Print your name using the `print` function\n",
     "5) Add two strings, e.g. \"hello\" + \"world\"\n",
-    "6) Run the file `hello.py` inside the REPL\n",
+    "6) Create the file `src/pycourse/main.py` that prints your name and run it inside the IPython REPL\n",
     "7) Same but print it's execution time"
    ]
   },
@@ -172,7 +172,7 @@
     "There are many options out there.\n",
     "Do not spend too much time deciding which to pick, you can always change your choice later.  \n",
     "[VS-Code](https://code.visualstudio.com/) is a reasonable general choice as of today, it is free and widely adopted.\n",
-    "For a user experience more similar to matlab and oriented to scientific computing you can check out [Spyder](https://www.spyder-ide.org)."
+    "For a user experience more similar to matlab or R-studio and oriented to scientific computing you can check out [Spyder](https://www.spyder-ide.org)."
    ]
   },
   {
@@ -183,7 +183,7 @@
     "## Jupyter Notebook\n",
     "Notebooks run on the browser and are a way to mix code with other kinds of data, such as images, videos or widgets.\n",
     "They are a very useful tool for explorative analysis.\n",
-    "If you ever used something like Mathematica you'll be already familiar with them.\n",
+    "If you ever used something like [Mathematica](https://www.wolfram.com/mathematica/) you'll be already familiar with them.\n",
     "\n",
     "There are several versions of notebooks, we are going to use [JupyterLab](https://jupyterlab.readthedocs.io/en/latest/).\n",
     "Let's install it:\n",
@@ -197,7 +197,16 @@
     "```bash\n",
     "mkdir noteboooks\n",
     "```\n",
+    "So far your project should look like this:\n",
     "\n",
+    "![](./images/tree.png)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "339a9009-15aa-4180-8770-1a165210a3d8",
+   "metadata": {},
+   "source": [
     "Launch a jupyterlab session:\n",
     "\n",
     "```bash\n",
@@ -233,7 +242,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.13"
+   "version": "3.13.3"
   }
  },
  "nbformat": 4,