make API documentation generator more flexible by allowing multiple sections, table sections, etc; use this to document the new validate() functionality