include doc generation in makefile
add structuring documentation comments
refine makefile for documentation