chore(doc_gen): add task to run doc-gen specs
fix(doc-gen): correctly transform index files

Closes #3021