made some changes to docs and makefiles