added validation
updated docstrings