add validateSync and small improvements

Add comments for this please - lack of comments makes docs build fail