Lots of doc work.

examples/Builtin Extensions/Index.ipynb

@@ -1,54 +1,65 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:fe4dbf207e38eb8151a0b18d1d01d727f9ee6ea3a08c16da17283f543d3b7925"
+  "signature": "sha256:a89ddd606f68e27067a5e2301a4d19a3c149131f4f07be4483a65979e26bebe0"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "Builtin Extensions"
      ]
     },
     {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "IPython extensions allow custom magic commands to be shipped as standalone libraries. IPython includes a few extensions that define magic commands for working with code in other languages.\n",
+      "\n",
+      "<div class=\"alert\" style=\"margin: 10px\">\n",
+      "We are in the process of moving these builtin extensions to their parent projects (Cython, oct2py and rpy2). Once this happens this documentation will move as well.\n",
+      "</div>"
+     ]
+    },
+    {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Cython Magics](Cython Magics.ipynb): magics for compiling and running Cython code in a cell\n",
       "* [Octave Magic](Octave Magic.ipynb): magics for running Octave code in a cell\n",
       "* [R Magics](R Magics.ipynb): magics for running R code in a cell"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Customization/Index.ipynb

@@ -1,53 +1,60 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:50f0a98d05f9e0c43ab5f1bc6dd6a5e61d64a7f585eb98526b45f8a82dcec827"
+  "signature": "sha256:9081cd113ba2044ff4184aca7ea71d8b9b8aa374d44ebc893e9d00b5bbd91217"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
-      "Customization of IPython"
+      "Customization"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "IPython has rich APIs for customization. Many behaviors of the different IPython applications can be configured using command line arguments or configuration files. IPython's core syntax and command line features can also be customized through input filters, custom magic commands, etc."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/IPython Kernel/Index.ipynb

@@ -1,53 +1,68 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:de5d592ea428f67f49f326d419774eff3e0b4402145bb5f3ce7cac49cc528080"
+  "signature": "sha256:0c0453ac3ddbb0ea6397e7f7216e6e005c4d1fe6e089921af39e874a411d7ed1"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
-      "Miscellaneous Topics"
+      "IPython Kernel"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "IPython provides extensions to the Python programming language that make working interactively convenient and efficient. These extensions are implemented in the IPython Kernel and are available in all of the IPython Frontends (Notebook, Terminal, Console and Qt Console) when running this kernel."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "* [Cell Magics](Cell Magics.ipynb)\n",
+      "* [Script Magics](Script Magics.ipynb)"
+     ]
+    },
+    {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Index.ipynb

@@ -1,59 +1,59 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:7aef917e7be3cb0881b911b9dbab7a5198c83ddfaaca6ec3499716f4a347c87b"
+  "signature": "sha256:f047f5edb4201c0c7aa38bdf31058bf6ab2785d53e7a03cdbd4e4ff4217c0007"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "IPython Documentation"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "This directory contains IPython's notebook-based documentation. This augments our [Sphinx-based documentation](http://ipython.org/ipython-doc/stable/index.html) with notebooks that contain interactive tutorials and examples. Over time, more of our documentation will be pulled into this format."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Topics"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "* [Core](Core/Index.ipynb): IPython's core syntax and command line features available in all of our frontends\n",
+      "* [IPython Kernel](IPython Kernel/Index.ipynb): IPython's core syntax and command line features available in all frontends\n",
       "* [Notebook](Notebook/Index.ipynb): The IPython Notebook frontend\n",
-      "* [Widgets](Widgets/Index.ipynb): Interactive JavaScript/HTML widgets and `interact`\n",
-      "* [Parallel](Parallel/Index.ipynb): IPython's library for interactive parallel computing\n",
+      "* [Interactive Widgets](Interactive Widgets/Index.ipynb): Interactive JavaScript/HTML widgets and `interact`\n",
+      "* [Parallel Computing](Parallel Computing/Index.ipynb): IPython's library for interactive parallel computing\n",
       "* [Customization](Customization/Index.ipynb): How to configure IPython and customize it with magics, extensions, etc.\n",
       "* [Embedding](Embedding/Index.ipynb): Embedding and reusing IPython's components into other applications\n",
       "* [Builtin Extensions](Builtin Extensions/Index.ipynb): Extensions we ship with IPython\n",
-      "* [Misc](Misc/Index.ipynb): Content that doesn't fit anywhere else"
+      "* [Miscellaneous](Miscellaneous/Index.ipynb): Documentation that doesn't fit anywhere else"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Interactive Widgets/Index.ipynb

@@ -1,96 +1,103 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:63baf57fdd892f6dd1f3c23b817e1458ebe337b6c5bc7114ff697054a5162f99"
+  "signature": "sha256:1aeb403a0ea9cc1412348f98ec713b798e197bed05d8bb28de6824095758487b"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
-      "Interactive JavaScript Widgets"
+      "Interactive Widgets"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "IPython includes an architecture for interactive widgets that tie together Python code running in the kernel and JavaScript/HTML/CSS  running in the browser. These widgets enable users to explore their code and data interactively."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "- [Using Interact](Using Interact.ipynb)\n",
-      "- [Widgets Overview](Widgets Overview.ipynb)  \n",
+      "- [Widget Basics](Widget Basic.ipynb)  \n",
       "- [Widget Events](Widget Events.ipynb)  \n",
       "- [Widget Placement](Widget Placement.ipynb)  \n",
       "- [Widget Styles](Widget Styles.ipynb)  \n",
       "- [Widget Alignment](Widget Alignment.ipynb)  \n",
       "- [Custom Widgets](Custom Widgets.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples of custom widgets"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "- [Variable Inspector](Variable Inspector.ipynb)  \n",
       "- [Export As (nbconvert)](Export As (nbconvert%29.ipynb)  \n",
       "- [Nonblocking Console](Nonblocking Console.ipynb)  \n",
       "- [File Upload Widget](File Upload Widget.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples using `interact`/`interactive`"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Beat Frequencies](Beat Frequencies.ipynb)\n",
       "* [Exploring Graphs](Exploring Graphs.ipynb)\n",
       "* [Factoring](Factoring.ipynb)\n",
       "* [Image Browser](Image Browser.ipynb)\n",
       "* [Image Processing](Image Processing.ipynb)\n",
       "* [Lorenz Differential Equations](Lorenz Differential Equations.ipynb)"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Miscellaneous/Index.ipynb

@@ -1,61 +1,60 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:d372ee882991ad9443b66587f16b75a398a5f3e451a6b29528d382b2724644d9"
+  "signature": "sha256:5a6c0780821e9af91f7138522ac5dc8d37ad7b23919120fba8d4de23fd6af80f"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
-      "Core Syntax and Command Line Features"
+      "Miscellaneous Topics"
      ]
     },
     {
-     "cell_type": "heading",
-     "level": 2,
+     "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Tutorials"
+      "Some IPython documentation topics just don't fit well anywhere else."
      ]
     },
     {
-     "cell_type": "markdown",
+     "cell_type": "heading",
+     "level": 2,
      "metadata": {},
      "source": [
-      "* [Cell Magics](Cell Magics.ipynb)\n",
-      "* [Script Magics](Script Magics.ipynb)"
+      "Tutorials"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Notebook/Index.ipynb

@@ -1,80 +1,87 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:19507dca85a5e09f662fc93e49fb001b373a583174be40845a9c6dba1f66ac68"
+  "signature": "sha256:52eeeb2e17ae8137146eb3d6af7253a87c74ffd1a6636c4cc47700c91a9fe0a5"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
-      "IPython Notebook"
+      "Notebook"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "The IPython Notebook is a web-based interactive computing system that enables users to author documents that include live code, narrative text, LaTeX equations, HTML, images and video. These documents are contain a full record of a computation and its results and can be shared on email, [Dropbox](http://dropbox.com), version control systems (like git/[GitHub](http://github.com)) or [nbviewer.ipython.org](http://nbviewer.ipython.org)."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [User Interface](User Interface.ipynb)\n",
       "* [Running Code](Running Code.ipynb)\n",
       "* [Basic Output](Basic Output.ipynb)\n",
       "* [Plotting with Matplotlib](Plotting with Matplotlib.ipynb)\n",
       "* [Markdown Cells](Markdown Cells.ipynb)\n",
       "* [Typesetting Math Using MathJax](Typesetting Math Using MathJax.ipynb)\n",
       "* [Display System](Display System.ipynb)\n",
       "* [Custom Display Logic](Custom Display Logic.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Trapezoid Rule](Trapezoid Rule.ipynb)\n",
       "* [SymPy](SymPy.ipynb)\n",
       "* [Raw Input](Raw Input.ipynb)\n",
       "* [Progress Bars](Progress Bars.ipynb)\n",
       "* [Importing Notebooks](Importing Notebooks.ipynb)\n",
       "* [Connecting with the Qt Console](Connecting with the Qt Console.ipynb)\n",
       "* [Animations Using clear_output](Animations Using clear_output.ipynb)"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Parallel Computing/Index.ipynb

@@ -1,72 +1,79 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:35aa32e4977a9f12e4e99e23e6e2f211a1d95c113d22d90077205dba085e8324"
+  "signature": "sha256:4b037603ce02b01191708017c52583e8e80f885f716a9e625a711742d96b49c9"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
-      "Parallel Computing with IPython"
+      "Parallel Computing"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "IPython includes an architecture and library for interactive parallel computing. The enables Python functions, along with their arguments, to be run in parallel a multicore CPU, cluster or cloud using a simple Python API."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Data Publication API](Data Publication API.ipynb) "
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Monitoring an MPI Simulation - 1](Monitoring an MPI Simulation - 1.ipynb)\n",
       "* [Monitoring an MPI Simulation - 2](Monitoring an MPI Simulation - 2.ipynb)\n",
       "* [Parallel Decorator and map](Parallel Decorator and map.ipynb)\n",
       "* [Parallel Magics](Parallel Magics.ipynb)\n",
       "* [Using Dill](Using Dill.ipynb)\n",
       "* [Using MPI with IPython Parallel](Using MPI with IPython Parallel.ipynb)"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file