couple more tests, fixes, validation documentation