Review

Author: s2t2

docs/notes/dev-tools/google-colab/pip.ipynb

@@ -16,11 +16,7 @@
     "\n",
     "But it is very common to want to use other packages in the Python ecosystem as well, including any packages we might find shared on [GitHub](https://github.com/), or hosted more officially on the Python Package Index ([PyPI](https://pypi.org/)), which is a centralized repository for all official Python packages.\n",
     "\n",
-    "To manage the Python package installation process, we use Python's sidekick, a command-line tool called [Pip](https://packaging.python.org/en/latest/tutorials/installing-packages/#use-pip-for-installing).\n",
-    "\n",
-    ":::{.callout-note}\n",
-    "In Google Colab, when we use terminal commands (such as `pip` commands), we prefix them with an exclamation point (!), to differentiate them from Python code.\n",
-    ":::\n"
+    "To manage the Python package installation process, we use Python's sidekick, a command-line tool called [Pip](https://packaging.python.org/en/latest/tutorials/installing-packages/#use-pip-for-installing).\n"
    ]
   },
   {
@@ -46,6 +42,16 @@
     "!pip --version"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    ":::{.callout-note}\n",
+    "In Google Colab, when we use terminal commands (such as `pip` commands), we prefix them with an exclamation point (!), to differentiate them from Python code.\n",
+    ":::"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,

docs/notes/python-lang/file-operations.qmd

@@ -25,18 +25,21 @@ We can use the `open` function in "writing" mode (`"w"`) to write text contents
 ```{python}
 filepath = "my_message.txt"
 
-# "w" means "open the file for writing":
 with open(filepath, "w") as file:
     file.write(message)
 ```
 
-Let's break this down. As the first parameter we first specify the name (or the full path) of the file we want to reference.
+Let's break this down.
 
-Then as the second parameter specifies the "mode", or the way in which we intend to open the file (i.e. reading or writing).
+When using the `open` function, we pass the name (or the full path) of the file as the first parameter, then the "mode", or the way in which we intend to open the file (i.e. reading or writing), as the second parameter.
 
+:::{.callout-note}
 FYI: the `with` statement creates a **context manager** that allows us to open the file without explicitly closing it. The file will be closed when the indentation level resets back to the left margin.
+:::
 
-FYI: here, `file` is an alias variable referencing the file object (technically a `TextIOWrapper` datatype). You can choose any variable name you like instead, just reference that same variable name inside the scope of the context manager when reading with the file's `read` method, or writing with the file's `write` method.
+:::{.callout-note}
+Here, `file` is an alias variable referencing the file object (technically a `TextIOWrapper` datatype). You can choose any variable name you like instead, just reference that same variable name inside the scope of the context manager when reading with the file's `read` method, or writing with the file's `write` method.
+:::
 
 ## Reading Files
 
@@ -45,15 +48,14 @@ To verify the contents got written to file, let's read the same file.
 Here we are use the `open` function in "reader" mode (`"r"`) to read the contents of the text file:
 
 ```{python}
-# "r" means "open the file for reading":
 with open(filepath, "r") as file:
     contents = file.read()
     print(contents)
 ```
 
 ## Removing Files
 
-We can use the `os` module to detect, and delete files:
+Finally, we can use the `os` module to detect, and delete files:
 
 ```{python}
 import os