improve documentation
validation for options form

Fixes #20