makefile minor fix
add lots of documentation
restructure docs
update docs
edit docs