Added documentation generation in the Makefile and fixed various comments