add a few hints
cleanup ipynb