small updates of documentation, small updates ipython notebook