fix makefile and add some notes