moved docs around and added makefile directives to fix rest
cross-referencing