Grammar and flow on Exercise1

* Edits based on my experience at PyCon

Author: mbbroberg

4-JupyterLab-UI/Exercise-1-solutions.ipynb

@@ -6,30 +6,31 @@
    "source": [
     "# Exercise 1 notebook\n",
     "\n",
-    "This has just solution, or if you just want tosee the finisehed homework.\n",
+    "This notebook contains solutions to the homework in this same folder (\"Exercise1.md\").\n",
     "\n",
-    "This is a markdown cell with **bold** _italic_ inline $math$, and formulas:\n",
+    "## Notebook operations and advanced operations\n",
+    "\n",
+    "This is a Markdown cell with **bold**, _italic_, in-line $math$, and formulas:\n",
     "\n",
     "$$f(x) =  a.x^2+b.x+c$$\n",
     "\n",
     "$$x_\\pm = \\frac{-b \\pm \\sqrt(b^2-4ac)}{2a}$$\n",
     "\n",
-    "Tribple backticks with llanguage\n",
+    "Here is an example with triple backticks and language-specific syntax highlighting:\n",
     "\n",
     "```python\n",
     "# I can write some code:\n",
     "from IPython.display import Math\n",
     "Math('\\Delta = b^2-4ac')\n",
     "```\n",
     "\n",
-    "Indented 4 spaces:\n",
+    "And an example with indented 4 spaces:\n",
     "\n",
     "    # I can write some code:\n",
     "    from IPython.display import Math\n",
     "    Math('\\Delta = b^2-4ac')\n",
     "\n",
-    "\n",
-    "Try to get a feel of the editor (select and press TAB...)"
+    "Keep getting the feel of the editor (select and press TAB...)"
    ]
   },
   {
@@ -60,7 +61,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Let's carry on with the exercise. To be efficient we'll lear to use the keyboard shortcuts. "
+    "Continuing on with the exercise remembering to use the keyboard shortcuts to be efficient. Use `Shift-Enter` to execute the following command:"
    ]
   },
   {
@@ -84,7 +85,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "You will notice that `Ctrl-Enter` execute a cell in place (and keep it selected), while `Shift-Enter` execute and select next. Finally, `Alt-Enter` execute and insert below."
+    "There are multiple options to run a cell. `Ctrl-Enter` execute a cell in place (and keeps it selected), while `Shift-Enter` execute and select next. Finally, `Alt-Enter` execute and insert below."
    ]
   },
   {
@@ -118,20 +119,20 @@
     }
    ],
    "source": [
-    "# crl-enter to iter through this.\n",
+    "# Use Ctrl-Enter to iterate through values of fib\n",
     "next(fib)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## kernel's related functionalities."
+    "Practice tab completion using the following example:"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 1,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -215,7 +216,7 @@
     }
    ],
    "source": [
-    "# tab\n",
+    "# tab to DataFrame\n",
     "pd.D"
    ]
   },
@@ -225,7 +226,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "#Shift-tab\n",
+    "# Shift-Tab to see DataFrame parameters\n",
     "pd.DataFrame("
    ]
   },
@@ -265,10 +266,11 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 54,
+   "execution_count": 2,
    "metadata": {},
    "outputs": [],
    "source": [
+    "## Use multiple cursors to uncomment the following\n",
     "#import IPython\n",
     "#ip = get_ipython()\n",
     "#ip.Completer.use_jedi = False"
@@ -370,9 +372,16 @@
     "df.head()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can use some % `magic` to run Matplotlib in-line in this notebook."
+   ]
+  },
   {
    "cell_type": "code",
-   "execution_count": 14,
+   "execution_count": 4,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -413,7 +422,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 17,
+   "execution_count": 6,
    "metadata": {},
    "outputs": [
     {
@@ -928,6 +937,13 @@
     "    print(i,\":\",i**2)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "You can even launch a browser pop-up through IPython:"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 19,
@@ -953,11 +969,11 @@
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
+   "cell_type": "markdown",
    "metadata": {},
-   "outputs": [],
-   "source": []
+   "source": [
+    "The end. 🎉"
+   ]
   }
  ],
  "metadata": {

4-JupyterLab-UI/Exercise1.md

@@ -43,8 +43,9 @@ Arrange the notebook and rendered markdown side-by-side. Then arrange them, one
 
 # More advanced notebooks
 
-- Move a cell by dragging
+- Move a cell by dragging.
 - Use the View menu, or click the blue bar, to collapse and expand an input and an output.
 - Use the context menu to enable scrolling in a cell that has lots of output.
-- Try “Create new view for output” in the context menu of an output. Modify and execute the cell again to see the mirrored output update (will learn more in section 2)
+- Try “Create new view for output” in the context menu of an output. Modify and execute the cell again to see the mirrored output update (will learn more in section 2).
 - Learn the various keyboard shortcuts through the menu and the command palette.
+- Learn more about kernel functionality (more on that in the exercise solution).