improved docs and makefile