added some documentation about verification