improvements to the notebooks