work on param validators

Signed-off-by: Adam Stokes <adam.stokes@ubuntu.com>
more method documentation

Signed-off-by: Adam Stokes <adam.stokes@ubuntu.com>
v1.5