Hi.

One of SymPy's Google Code-In students just completed one of the
"Create Examples/Short Tutorials Using IPython's Notebook (IPython >=
0.12)" tasks (see
http://www.google-melange.com/gci/task/view/google/gci2011/7129292,
and also http://code.google.com/p/sympy/issues/detail?id=2790).

The student's example notebook is very nice, and I really like the
notebook for this medium.  I think we should convert all of our
examples in the examples/ directory to use notebooks.  Right now, they
are just annotated scripts that print things to the terminal, which
isn't very helpful, because you can read either the code or the
output, but it's hard to see both at the same time.

The issue is how to properly doctest these.  Is there an easy way to
doctest IPython notebooks?  I am also CC'ing IPython User list.

By the way, this would also improve our testing of the examples if we
can do this.  Right now, we just test that they don't produce any
errors, but we don't test the output itself, unless it is also tested
by a regular test (which they all should be, but I suspect not all
are).

Finally, if we do this, I think we should add something in ./setup.py
dist (or similar) that automatically adds pdf copies of all the
notebooks, so that people who don't have IPython can still read the
examples. Is there an easy way to do this?

Aaron Meurer

-- 
You received this message because you are subscribed to the Google Groups 
"sympy" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sympy?hl=en.

Reply via email to