DOC: Add link to notebook and crosslink ref. Closes #924.
Merge pull request #1012 from jseabold/notebook-links

DOC: Add link to notebook and crosslink ref. Closes #924.
DOC: nbgenerate does not like the comment at end of line.