small formatting updates
added script docs and users manual