updated spec with validation samples