Merge pull request #560 from tobyhodges/inline-instructor-notes

Inline instructor notes

Author: btovar

episodes/02-starting-with-data.md

@@ -478,6 +478,16 @@ max        280.000000
 Name: weight, dtype: float64
 ```
 
+:::::::::::::::::::::::::::::::::::::::::  instructor
+
+## Important Bug Note
+
+In pandas prior to version 0.18.1
+there is a bug causing `surveys_df['weight'].describe()` to 
+return a runtime error.
+
+:::::::::::::::::::::::::::::::::::::::::::::::::::::
+
 We can also extract one specific metric if we wish:
 
 ```python

episodes/03-index-slice-subset.md

@@ -25,6 +25,18 @@ exercises: 30
 
 ::::::::::::::::::::::::::::::::::::::::::::::::::
 
+::::::::::::::::::::::: instructor
+
+Tip: use `.head()` method throughout this lesson to keep your display neater for students.
+Encourage students to try with and without `.head()` 
+to reinforce this useful tool and then to use it or not at their preference.
+
+For example, if a student worries about keeping up in pace with typing,
+let them know they can skip the `.head()`,
+but that you'll use it to keep more lines of previous steps visible.
+
+::::::::::::::::::::::::::::::::::
+
 In the first episode of this lesson, we read a CSV file into a pandas' DataFrame. We learned how to:
 
 - save a DataFrame to a named object,

episodes/07-visualization-ggplot-python.md

@@ -92,6 +92,18 @@ To build a `plotnine` graphic we need to:
 (p9.ggplot(data=surveys_complete))
 ```
 
+::::::::::::::::::::::: instructor
+
+Note `plotnine` contains a *lot* of deprecation warnings in some versions of python/matplotlib, 
+warnings may need to be suppressed with
+
+```python
+import warnings
+warnings.filterwarnings(action='once')
+```
+
+::::::::::::::::::::::::::::::::::
+
 As we have not defined anything else, just an empty figure is available and
 presented.
 

instructors/instructor-notes.md

@@ -25,48 +25,27 @@ If learners receive an `AssertionError`, it will inform you how to help them cor
 installation. Otherwise, it will tell you that the system is good to go and ready for Data
 Carpentry!
 
-
-## 02-starting-with-data
-
-:::::::::::::::::::::::::::::::::::::::::  callout
-
-## Important Bug Note
-
-In Pandas prior to 0.18.1 there is a bug causing `surveys_df['weight'].describe()` to return
-a runtime error.
-
-::::::::::::::::::::::::::::::::::::::::::::::::::
-
-## 03-index-slice-subset
-
-Tip: use `.head()` method throughout this lesson to keep your display neater for students.
-Encourage students to try with and without `.head()` to reinforce this useful tool and then to use
-it or not at their preference. For example, if a student worries about keeping up in pace with
-typing, let them know they can skip the `.head()`, but that you'll use it to keep more lines of
-previous steps visible.
-
 ## 07-visualization-ggplot-python
 
-Note `plotnine` contains a *lot* of deprecation warnings in some versions of python/matplotlib, warnings may need to be supressed with
-
-```python
-import warnings
-warnings.filterwarnings(action='once')
-```
-
 iPython notebooks for plotting can be viewed in the `learners` folder.
 
 ## 08-putting-it-all-together
 
-Answers are embedded with challenges in this lesson, other than random distribtuion which is left to the learner to choose, and final plot, for which the learner should investigate the matplotlib gallery.
-
-Scientists often operate on mathematical equations. Being able to use them in their graphics has a
-lot of added value. Luckily, Matplotlib provides powerful tools for text control. One of them is the
-ability to use LaTeX mathematical notation, whenever text is used (you can learn more about LaTeX
-math notation here: [https://en.wikibooks.org/wiki/LaTeX/Mathematics](https://en.wikibooks.org/wiki/LaTeX/Mathematics)). To use mathematical
-notation, surround your text using the dollar sign ("$").  LaTeX uses the backslash character ("\\")
-a lot. Since backslash has a special meaning in the Python strings, you should replace all the
-LaTeX-related backslashes with two backslashes.
+Answers are embedded with challenges in this lesson, 
+other than random distribtuion which is left to the learner to choose,
+and final plot, for which the learner should investigate the matplotlib gallery.
+
+Scientists often operate on mathematical equations.
+Being able to use them in their graphics has a lot of added value
+Luckily, Matplotlib provides powerful tools for text control.
+One of them is the ability to use LaTeX mathematical notation, 
+whenever text is used
+(you can learn more about LaTeX math notation here: [https://en.wikibooks.org/wiki/LaTeX/Mathematics](https://en.wikibooks.org/wiki/LaTeX/Mathematics)).
+To use mathematical notation, surround your text using the dollar sign ("$").
+
+LaTeX uses the backslash character ("\\") a lot.
+Since backslash has a special meaning in the Python strings,
+you should replace all the LaTeX-related backslashes with two backslashes.
 
 ```python
 plt.plot(t, t, 'r--', label='$y=x$')