Auto-generate API documentation. Refactor code.

Generate API documentation directly from docstrings. Re-write several docstrings
to be clearer and use Sphinx directives.

Refactor the logic behind `codify` and `FauxFactory.generate_string`.
Niice