validation for plugins. added more docs for child plugins

fixes #2410 
fixes #2481