incorporate @drammock's feedback into the notebook

Author: gabalafou

docs/examples/code-cells.ipynb

@@ -139,9 +139,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The standard error stream is highlighted and displayed just below the code cell.\n",
-    "The standard output stream comes afterwards (with no special highlighting).\n",
-    "Finally, the \"normal\" output is displayed."
+    "Normal output comes last. When both standard error and output are present, which one comes first can vary by kernel."
    ]
   },
   {
@@ -270,6 +268,13 @@
     "### Image URLs"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "PNG format"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -279,6 +284,13 @@
     "Image(url=\"https://www.python.org/static/img/python-logo-large.png\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "PNG format, `embed=True`"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -288,6 +300,13 @@
     "Image(url=\"https://www.python.org/static/img/python-logo-large.png\", embed=True)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "SVG format"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -368,6 +387,8 @@
    "source": [
     "<div class=\"alert alert-info\">\n",
     "\n",
+    "Note\n",
+    "\n",
     "Make sure to use at least version 0.1.6 of the `matplotlib-inline` package\n",
     "(which is an automatic dependency of the `ipython` package).\n",
     "\n",
@@ -437,6 +458,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "%config InlineBackend.figure_formats = ['svg']\n",
     "fig, ax = plt.subplots(figsize=[6, 3])\n",
     "ax.plot([4, 9, 7, 20, 6, 33, 13, 23, 16, 62, 8]);"
    ]