broke out validation dict validation into its own function; updated docstrings to comply with PEP-257