Rough top to the new docs

docs/_build_html/_sources/index.rst.txt

@@ -1,20 +1,23 @@
-.. First Python Notebook documentation master file, created by
-   sphinx-quickstart on Sat Feb 11 12:41:58 2017.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
+:tocdepth: 2
 
-Welcome to First Python Notebook's documentation!
-=================================================
+=====================
+First Python Notebook
+=====================
 
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
+A step-by-step guide to analyzing data with Python and the Jupyter Notebook.
 
+It was developed by `Ben Welsh <http://palewi.re/who-is-ben-welsh/>`_ for a `Oct. 2, 2016, "watchdog workshop" organized by Investigative Reporters and Editors <http://ire.org/events-and-training/event/2819/2841/>`_
+at San Diego State University's school of journalism. It is scheduled to be taught to students at Stanford's Journalism School
+and at the annual conference of the National Institute for Computer-Assisted Reporting in early 2017.
 
+What you will learn
+-------------------
 
-Indices and tables
-==================
+This three-hour tutuorial will guide you through an investigation of money in politics using data from the `California Civic Data Coalition <http://www.californiacivicdata.org/>`_.
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+You will learn just enough Python to do damage with the powerful `pandas <http://pandas.pydata.org/>`_  data analysis library, the most popular open-source
+library for working with large data files. You will also learn how to record, remix and republish your analysis
+using the `Jupyter Notebook <http://jupyter.org/>`_, a browser-based tool for writing code
+that is emerging as the standard for sharing reproducible research in the sciences.
+
+And most important: you will see how these tools can increase the speed and veracity of your journalism.

docs/_build_html/index.html

@@ -8,7 +8,7 @@
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  <title>Welcome to First Python Notebook’s documentation! &mdash; First Python Notebook  documentation</title>
+  <title>First Python Notebook &mdash; First Python Notebook  documentation</title>
 
 
 
@@ -80,8 +80,10 @@
 
                 <!-- Local TOC -->
                 <div class="local-toc"><ul>
-<li><a class="reference internal" href="#">Welcome to First Python Notebook&#8217;s documentation!</a></li>
-<li><a class="reference internal" href="#indices-and-tables">Indices and tables</a></li>
+<li><a class="reference internal" href="#">First Python Notebook</a><ul>
+<li><a class="reference internal" href="#what-you-will-learn">What you will learn</a></li>
+</ul>
+</li>
 </ul>
 </div>
 
@@ -112,7 +114,7 @@
   <ul class="wy-breadcrumbs">
     <li><a href="#">Docs</a> &raquo;</li>
 
-    <li>Welcome to First Python Notebook&#8217;s documentation!</li>
+    <li>First Python Notebook</li>
       <li class="wy-breadcrumbs-aside">
 
 
@@ -126,18 +128,21 @@
           <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
            <div itemprop="articleBody">
 
-  <div class="section" id="welcome-to-first-python-notebook-s-documentation">
-<h1>Welcome to First Python Notebook&#8217;s documentation!<a class="headerlink" href="#welcome-to-first-python-notebook-s-documentation" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-</div>
+  <div class="section" id="first-python-notebook">
+<h1>First Python Notebook<a class="headerlink" href="#first-python-notebook" title="Permalink to this headline">¶</a></h1>
+<p>A step-by-step guide to analyzing data with Python and the Jupyter Notebook.</p>
+<p>It was developed by <a class="reference external" href="http://palewi.re/who-is-ben-welsh/">Ben Welsh</a> for a <a class="reference external" href="http://ire.org/events-and-training/event/2819/2841/">Oct. 2, 2016, &#8220;watchdog workshop&#8221; organized by Investigative Reporters and Editors</a>
+at San Diego State University&#8217;s school of journalism. It is scheduled to be taught to students at Stanford&#8217;s Journalism School
+and at the annual conference of the National Institute for Computer-Assisted Reporting in early 2017.</p>
+<div class="section" id="what-you-will-learn">
+<h2>What you will learn<a class="headerlink" href="#what-you-will-learn" title="Permalink to this headline">¶</a></h2>
+<p>This three-hour tutuorial will guide you through an investigation of money in politics using data from the <a class="reference external" href="http://www.californiacivicdata.org/">California Civic Data Coalition</a>.</p>
+<p>You will learn just enough Python to do damage with the powerful <a class="reference external" href="http://pandas.pydata.org/">pandas</a>  data analysis library, the most popular open-source
+library for working with large data files. You will also learn how to record, remix and republish your analysis
+using the <a class="reference external" href="http://jupyter.org/">Jupyter Notebook</a>, a browser-based tool for writing code
+that is emerging as the standard for sharing reproducible research in the sciences.</p>
+<p>And most important: you will see how these tools can increase the speed and veracity of your journalism.</p>
 </div>
-<div class="section" id="indices-and-tables">
-<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1>
-<ul class="simple">
-<li><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></li>
-<li><a class="reference internal" href="py-modindex.html"><span class="std std-ref">Module Index</span></a></li>
-<li><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></li>
-</ul>
 </div>
 
 

docs/index.rst

@@ -1,20 +1,23 @@
-.. First Python Notebook documentation master file, created by
-   sphinx-quickstart on Sat Feb 11 12:41:58 2017.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
+:tocdepth: 2
 
-Welcome to First Python Notebook's documentation!
-=================================================
+=====================
+First Python Notebook
+=====================
 
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
+A step-by-step guide to analyzing data with Python and the Jupyter Notebook.
 
+It was developed by `Ben Welsh <http://palewi.re/who-is-ben-welsh/>`_ for a `Oct. 2, 2016, "watchdog workshop" organized by Investigative Reporters and Editors <http://ire.org/events-and-training/event/2819/2841/>`_
+at San Diego State University's school of journalism. It is scheduled to be taught to students at Stanford's Journalism School
+and at the annual conference of the National Institute for Computer-Assisted Reporting in early 2017.
 
+What you will learn
+-------------------
 
-Indices and tables
-==================
+This three-hour tutuorial will guide you through an investigation of money in politics using data from the `California Civic Data Coalition <http://www.californiacivicdata.org/>`_.
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+You will learn just enough Python to do damage with the powerful `pandas <http://pandas.pydata.org/>`_  data analysis library, the most popular open-source
+library for working with large data files. You will also learn how to record, remix and republish your analysis
+using the `Jupyter Notebook <http://jupyter.org/>`_, a browser-based tool for writing code
+that is emerging as the standard for sharing reproducible research in the sciences.
+
+And most important: you will see how these tools can increase the speed and veracity of your journalism.