docs tweaks and makefile update