simplify readme

README.md

@@ -13,7 +13,7 @@ This repository contains Jupyter notebooks related to music information retrieva
 
 The simplest way to use this repository is to (1) browse a read-only version of this repo at [musicinformationretrieval.com](http://musicinformationretrieval.com), and (2) follow along using a blank Jupyter notebook of your own.
 
-### Install Python and relevant libraries
+### Installation
 
 1.  Download and install [Anaconda for Python 3.x](https://www.anaconda.com/download).
     
@@ -37,48 +37,46 @@ To upgrade, `conda upgrade`.
 -   pandas 0.22.0
 -   joblib 0.11
 
-### Troubleshooting
-
-[Issue #729](https://github.com/librosa/librosa/issues/729): `import librosa` causes `TypeError: expected string or buffer` 
-
--   Workaround: downgrade `joblib` to v0.11:
-
-        pip install joblib==0.11
-
-### Start the Jupyter Notebook
-
-A majority of our instruction and laboratory work will occur inside the [Jupyter notebook](http://jupyter.org/). You can think of the Jupyter notebook like the Mathematica or Matlab desktop, except it uses Python and it runs inside your web browser.
+### Usage
 
-1.  Start the Jupyter notebook server on your local machine. For Mac users, at the Terminal:
+1.  Start the [Jupyter notebook](http://jupyter.org/) server on your local machine. For Mac users, at the Terminal:
 
         your-local-machine:~$ jupyter notebook
 
     For Windows users, open the application "Jupyter Notebook". Alternatively for Windows: open the application "Anaconda Prompt" and type in `jupyter notebook`.
 
-2.  On your local machine, visit <http://localhost:8888> inside a web browser. 
+    Jupyter should automatically open a new window in your web browser that resembles a directory tree.
 
-3.  To open a new notebook, click on *New* near the top right. This is your scrap notebook. 
+2.  To open a new notebook, in the new window of your web browser, click on *New* near the top right to open a new notebook.
 
-    -   Immediately rename the notebook by clicking on "Untitled" in the top left, and choosing a different name.
+    -   To rename the notebook, click on "Untitled" in the top left, and choose a different name.
     -   Inside a cell, run `1+2`. Press `<Shift-Enter>` on a cell to run that cell. Hopefully you get the output `3`.
     -   Inside a cell, run `import scipy, sklearn, pandas, librosa`. Press `<Shift-Enter>` to run the cell. If that runs without error, congratulations, you have the necessary libraries installed properly.
     -   Try executing the content from <http://musicinformationretrieval.com> inside this blank notebook.
 
-4.  To close the Jupyter notebook,
+3.  To close the Jupyter notebook,
 
     -   Save the notebook. (Either use keyboard shortcut `s`, or "File | Save" in the top menu.)
     -   Close the browser window.
     -   If you opened the notebook from a prompt/shell as indicated in Step 1 above, from that shell, press `<Ctrl-C>` twice to return to the prompt.
 
-Congratulations, you are now running a Jupyter notebook, and you can get started with the workshop material.
+Congratulations, you are now running a Jupyter notebook, and you can get started with the notebooks in this repository.
 
 After installing, if something doesn’t work, try closing the terminal or restarting the OS. Sometimes that can reset the necessary configurations.
 
+### Troubleshooting
+
+[Issue #729](https://github.com/librosa/librosa/issues/729): `import librosa` causes `TypeError: expected string or buffer` 
+
+-   Workaround: downgrade `joblib` to v0.11:
+
+        pip install joblib==0.11
+
 
 Contributions
 -------------
 
-Your contributions are very welcome! You can contribute in two ways:
+Your contributions are welcome! You can contribute in two ways:
 
 1. Submit an issue. Click on "[Issues](https://github.com/stevetjoa/musicinformationretrieval.com/issues)" in the right navigation bar, then "New Issue".  Issues can include Python bugs, spelling mistakes, broken links, requests for new content, and more.