Fix doc blocks.
Change implied doc block to be more clear as to what is implied.
Add new sometimes short-cut rule to only run validation if field is actually present.
Merge pull request #3201 from s1owjke/docs-fix

Docblocks fix