Reorganize the options docs and add validator option.

Refs cakephp/cakephp#3918