Fixed small formatting issues and minor namespace related stuff
added more comments
fixed markdown