fix bugs on how make file was provided, update docs for how-to