further reading and some exercises
adding a numpy example
add a note about the new api