Update top-level README

- Fix links and other misc cleanups
- Add deprecation notice for Project 2. Closes #74
- Remove Twitter/PythonJournos in Help section. Addresses #79

README.md

@@ -7,7 +7,7 @@
        `-'
 ```
 
-## Python mini bootcamp
+# Python mini bootcamp
 
 In this two-day workshop, we'll learn the basics of the Python programming language and how to begin analyzing data in a Jupyter Notebook. What's a Notebook? It's an interactive coding environment that lets you blend words and code.
 
@@ -24,36 +24,45 @@ Bear with us. It will all make sense soon.
 * What can I do with it?
 * GOAL: Learn how to solve problems with code.
 
-### [The Basics](https://github.com/ireapps/pycar/tree/master/basics)
+### [The Basics](basics/README.md)
 Key concepts of programming in Python:
 
 - Basic data types - strings, integers, lists
 - Lists are your friend!
 - etc
 
-### A [discussion on debugging](https://docs.google.com/presentation/d/e/2PACX-1vTCwzQnH0Ps8xmqnxGBYayCyas8-53qJyo-yjIy5qy4P2xUOA-kiAOQCNTiCzRBVX7TxeBabx1pvpBQ/pub?start=false&loop=false&delayms=3000) and [cheatsheet](https://github.com/ireapps/pycar/tree/master/debug/DebugginginPython.pdf)
+> Bonus: a [discussion on debugging][] and handy [cheatsheet](debug/DebugginginPython.pdf)
 
+[discussion on debugging]: https://docs.google.com/presentation/d/e/2PACX-1vTCwzQnH0Ps8xmqnxGBYayCyas8-53qJyo-yjIy5qy4P2xUOA-kiAOQCNTiCzRBVX7TxeBabx1pvpBQ/pub?start=false&loop=false&delayms=3000
+
+## Day 2
+
+### [Project #1](project1/README.md)
 
-### Day 2
-#### [Project #1](https://github.com/ireapps/pycar/tree/master/project1)
 As with many data analyses, it all starts with a CSV. After a white board exercise, we'll start with a file of pseudocode, and we'll walk through writing the program in Python code, running each line in the Jupyter interpreter. We'll hold your hand through each step of the process.
 
-### [Project #2](https://github.com/ireapps/pycar/tree/master/project2)
+### [Project #2](/project2/README.md)
+
+> This project is out-of-date. We'll try to update it in the near future.
+
 This section covers gathering data from the web in two common formats.
+
 In the first part, we'll scrape structured data from an HTML page using a GET request and write the data to a CSV. In the second part, we'll request data from an API to get information programmatically to create a spreadsheet. Our data comes in a new format: JSON. We'll do some more with the white board to show how it's basically a combination of data structures we already know about: Lists and dictionaries (arrays and objects).
 
-### [Project #3](https://github.com/ireapps/pycar/tree/master/project3)
-Now we get to the heart of data analysis with an introduction to the powerful `pandas` library. Building on the basic objects we've already learned, and on a little knowledge of SQL, we'll clean two related tables of data, join and filter them.
+### [Project #3](project3/analyzing_data_with_pandas_notebook.ipynb)
+
+Now we get to the heart of data analysis with an introduction to the powerful [pandas](https://pandas.pydata.org/docs/index.html) library. Building on the basics we've already learned, and a little knowledge of [SQL](https://en.wikipedia.org/wiki/SQL), we'll clean two related tables of data, join and filter them.
 
 At the end of the day, we'll __[send you home with](takehome/README.md)__:
 
-* A [lightning dash](https://github.com/ireapps/pycar/tree/master/takehome/PyCAR_basics_takehome_notebook_complete.ipynb) through basic variables, types and functions
-* The [working, commented code](https://github.com/ireapps/pycar/tree/master/completed) for each project from our git repo
+* A [lightning dash](takehome/PyCAR_basics_takehome_notebook_complete.ipynb) through basic variables, types and functions
+* The [working, commented code](completed/) for each project from our git repo
 * A walkthrough for [setting up your machine at home with Python](https://github.com/thejqs/pycar/blob/master/takehome/Installing%20Python%20The%20IRE%20Way%E2%84%A2.pdf), version control and virtualenvs
 * Good libraries to explore with strong tutorials
 * A lifetime support guarantee [from us](CONTRIBUTORS.md) & [PythonJournos](https://groups.google.com/forum/#!forum/PythonJournos)
 
-### Help!
+## Help!
+
 If you're working through this code at home and have trouble, please let us know.
-The best option is to [file an issue report](https://github.com/ireapps/pycar/issues?q=is%3Aopen+is%3Aissue) of the bug so we can help you.
-You can also reach out to any of us [on Twitter](https://github.com/ireapps/pycar/blob/master/CONTRIBUTORS.md) or ping [PythonJournos](https://groups.google.com/forum/#!forum/PythonJournos).
+
+The best way to reach us is by [submitting an Issue](https://github.com/ireapps/pycar/issues?q=is%3Aopen+is%3Aissue) on GitHub.