diff --git a/README.md b/README.md index 84ce194d5..a23c2fead 100644 --- a/README.md +++ b/README.md @@ -441,6 +441,31 @@ FAQ gem uninstall pygments.rb --version "=0.5.2" gem install pygments.rb --version "=0.5.0" +* *What do I do if I see a `File not found: u'nbconvert'` when I run `make check`?* +
+ The output of `make check` looks like this: + + WARNING: Unrecognized alias: 'output', it will probably have no effect.[TerminalIPythonApp] File not found: u'nbconvert' + cp tmp/python/novice/01-numpy.html _site/python/novice/01-numpy.html + cp: cannot stat ‘tmp/python/novice/01-numpy.html’: No such file or directory + + This means you don't have a recent enough version of IPython (below 1.0) and you should install a newer version. + Installing a local version can be done with: + + pip install --upgrade --user ipython + + You might need `pip` that can be installed (under Ubuntu and alike) with: + + sudo apt-get install python-pip + +* *What if I get some missing packages messages when I run `make check`?* +
+ Some additional packages are required. They can be installed (under Ubuntu and alike) with: + + sudo apt-get install pandoc jinja2 + + Installation of `jinja2` can also be carried on using `pip`. + * *Where should pages go if multiple boot camps are running at a site simultaneously?*
Use subdirectories like `2013-07-01-esu/beginners`, diff --git a/git/novice/guide.md b/git/novice/guide.md index b8b9bbd11..e12c9dba8 100644 --- a/git/novice/guide.md +++ b/git/novice/guide.md @@ -8,7 +8,7 @@ Version control might be the most important topic we teach, but Git is definitely the most complicated tool. However, GitHub presently dominates the open software forge landscape, -so we have help novices learn just enough Git +so we have to help novices learn just enough Git to feel they can and should learn more on their own. This is why we don't teach branching: