Currently, we have both md and ipynb files, but they should be kept in sync. Add a makefile to do make it the easiest both for contributors and CI.