improved documentation for new scripts