DOcument that verify() apis should be provided
Reword for clarity
Merge pull request #516 from alex/design-principle-verify

DOcument that verify() apis should be provided