RedHatQE/cfme_tests — pull request #306 by seandst (2014-01-17 22:17:49+00:00)
Title: Docs craziness...

This is a crazy idea, and at this point not ready to go because it has some setup/teardown that we need to automate.

Setup:
`for module in cfme fixtures utils; do sphinx-apidoc -o docs/modules/$module/ $module; done`

Teardown:
`rm -r docs/modules`

Goal:
I want to just write docs in code, and not have to think about linking them all into the sphinx tocs. I think this will make it easier for developers to include docs, as well.

Outstanding issues:
At this point, I don't know the best way to make readthedocs run `sphinx-apidoc` for us. I assume it will involve shenanigans in `docs/conf.py`.