update documentation and improved script output