[doc] verify before doc gen

should provide much better error messaging
closes #11