docblocks / added validated flag