add notes
adapt Makefile to the updated version of _oasis