ported more documentation
first stub for new validation API
new validation and feedback api