Ported in existing prequsites

docs/_build_html/_sources/index.rst.txt

@@ -10,6 +10,7 @@ It was developed by `Ben Welsh <http://palewi.re/who-is-ben-welsh/>`_ for a `Oct
 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
 -------------------
 
@@ -21,3 +22,40 @@ using the `Jupyter Notebook <http://jupyter.org/>`_, a browser-based tool for wr
 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.
+
+
+Prelude: Prequisites
+--------------------
+
+Before you can begin, your computer needs the following tools installed and working to participate.
+
+1. A `command-line interface <https://en.wikipedia.org/wiki/Command-line_interface>`_ to interact with your computer
+2. Version 2.7 of the `Python <http://python.org/download/releases/2.7.6/>`_ programming language
+3. The `pip <https://pip.pypa.io/en/latest/installing.html>`_ package manager and `virtualenv <http://www.virtualenv.org/en/latest/>`_ environment manager for Python
+
+
+Command-line interface
+~~~~~~~~~~~~~~~~~~~~~~
+
+Unless something is wrong with your computer, there should be a way to open a window that lets you type in commands. Different operating systems give this tool slightly different names, but they all have some form of it, and there are alternative programs you can install as well.
+
+On Windows you can find the command-line interface by opening the "command prompt." Here are instructions for `Windows 10 <http://www.howtogeek.com/235101/10-ways-to-open-the-command-prompt-in-windows-10/) and for [Windows 8](http://windows.microsoft.com/en-us/windows/command-prompt-faq#1TC=windows-8) and [earlier versions](http://windows.microsoft.com/en-us/windows-vista/open-a-command-prompt-window>`_.
+On Apple computers, you open the `"Terminal" application <http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line>`_.
+Ubuntu Linux comes with a program of the `same name <http://askubuntu.com/questions/38162/what-is-a-terminal-and-how-do-i-open-and-use-it>`_.
+
+
+Python
+~~~~~~
+
+If you are using Mac OSX or a common flavor of Linux, Python version 2.7 is probably already installed and you can test to see what version,
+if any, is already available by typing the following into your terminal.
+
+.. code-block:: bash
+
+    python -V
+
+Even if you find it already on your machine, Mac users should install it separately by following
+`these instructions <http://docs.python-guide.org/en/latest/starting/install/osx/>`_ offered by The Hitchhikers Guide to Python.
+
+Windows people can find a similar guide `here <http://docs.python-guide.org/en/latest/starting/install/win/>`_ which will have them try
+downloading and installing Python from `here <https://www.python.org/downloads/release/python-2712/>`_.

docs/_build_html/index.html

@@ -82,6 +82,7 @@
                 <div class="local-toc"><ul>
 <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>
+<li><a class="reference internal" href="#prelude-prequisites">Prelude: Prequisites</a></li>
 </ul>
 </li>
 </ul>
@@ -143,6 +144,34 @@ <h2>What you will learn<a class="headerlink" href="#what-you-will-learn" title="
 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="prelude-prequisites">
+<h2>Prelude: Prequisites<a class="headerlink" href="#prelude-prequisites" title="Permalink to this headline">¶</a></h2>
+<p>Before you can begin, your computer needs the following tools installed and working to participate.</p>
+<ol class="arabic simple">
+<li>A <a class="reference external" href="https://en.wikipedia.org/wiki/Command-line_interface">command-line interface</a> to interact with your computer</li>
+<li>Version 2.7 of the <a class="reference external" href="http://python.org/download/releases/2.7.6/">Python</a> programming language</li>
+<li>The <a class="reference external" href="https://pip.pypa.io/en/latest/installing.html">pip</a> package manager and <a class="reference external" href="http://www.virtualenv.org/en/latest/">virtualenv</a> environment manager for Python</li>
+</ol>
+<div class="section" id="id1">
+<h3>Command-line interface<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
+<p>Unless something is wrong with your computer, there should be a way to open a window that lets you type in commands. Different operating systems give this tool slightly different names, but they all have some form of it, and there are alternative programs you can install as well.</p>
+<p>On Windows you can find the command-line interface by opening the &#8220;command prompt.&#8221; Here are instructions for <a class="reference external" href="http://www.howtogeek.com/235101/10-ways-to-open-the-command-prompt-in-windows-10/)andfor[Windows8](http://windows.microsoft.com/en-us/windows/command-prompt-faq#1TC=windows-8)and[earlierversions](http://windows.microsoft.com/en-us/windows-vista/open-a-command-prompt-window">Windows 10</a>.
+On Apple computers, you open the <a class="reference external" href="http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line">&#8220;Terminal&#8221; application</a>.
+Ubuntu Linux comes with a program of the <a class="reference external" href="http://askubuntu.com/questions/38162/what-is-a-terminal-and-how-do-i-open-and-use-it">same name</a>.</p>
+</div>
+<div class="section" id="id2">
+<h3>Python<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
+<p>If you are using Mac OSX or a common flavor of Linux, Python version 2.7 is probably already installed and you can test to see what version,
+if any, is already available by typing the following into your terminal.</p>
+<div class="highlight-bash"><div class="highlight"><pre><span></span>python -V
+</pre></div>
+</div>
+<p>Even if you find it already on your machine, Mac users should install it separately by following
+<a class="reference external" href="http://docs.python-guide.org/en/latest/starting/install/osx/">these instructions</a> offered by The Hitchhikers Guide to Python.</p>
+<p>Windows people can find a similar guide <a class="reference external" href="http://docs.python-guide.org/en/latest/starting/install/win/">here</a> which will have them try
+downloading and installing Python from <a class="reference external" href="https://www.python.org/downloads/release/python-2712/">here</a>.</p>
+</div>
+</div>
 </div>
 
 

docs/index.rst

@@ -10,6 +10,7 @@ It was developed by `Ben Welsh <http://palewi.re/who-is-ben-welsh/>`_ for a `Oct
 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
 -------------------
 
@@ -21,3 +22,40 @@ using the `Jupyter Notebook <http://jupyter.org/>`_, a browser-based tool for wr
 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.
+
+
+Prelude: Prequisites
+--------------------
+
+Before you can begin, your computer needs the following tools installed and working to participate.
+
+1. A `command-line interface <https://en.wikipedia.org/wiki/Command-line_interface>`_ to interact with your computer
+2. Version 2.7 of the `Python <http://python.org/download/releases/2.7.6/>`_ programming language
+3. The `pip <https://pip.pypa.io/en/latest/installing.html>`_ package manager and `virtualenv <http://www.virtualenv.org/en/latest/>`_ environment manager for Python
+
+
+Command-line interface
+~~~~~~~~~~~~~~~~~~~~~~
+
+Unless something is wrong with your computer, there should be a way to open a window that lets you type in commands. Different operating systems give this tool slightly different names, but they all have some form of it, and there are alternative programs you can install as well.
+
+On Windows you can find the command-line interface by opening the "command prompt." Here are instructions for `Windows 10 <http://www.howtogeek.com/235101/10-ways-to-open-the-command-prompt-in-windows-10/) and for [Windows 8](http://windows.microsoft.com/en-us/windows/command-prompt-faq#1TC=windows-8) and [earlier versions](http://windows.microsoft.com/en-us/windows-vista/open-a-command-prompt-window>`_.
+On Apple computers, you open the `"Terminal" application <http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line>`_.
+Ubuntu Linux comes with a program of the `same name <http://askubuntu.com/questions/38162/what-is-a-terminal-and-how-do-i-open-and-use-it>`_.
+
+
+Python
+~~~~~~
+
+If you are using Mac OSX or a common flavor of Linux, Python version 2.7 is probably already installed and you can test to see what version,
+if any, is already available by typing the following into your terminal.
+
+.. code-block:: bash
+
+    python -V
+
+Even if you find it already on your machine, Mac users should install it separately by following
+`these instructions <http://docs.python-guide.org/en/latest/starting/install/osx/>`_ offered by The Hitchhikers Guide to Python.
+
+Windows people can find a similar guide `here <http://docs.python-guide.org/en/latest/starting/install/win/>`_ which will have them try
+downloading and installing Python from `here <https://www.python.org/downloads/release/python-2712/>`_.