update design doc, support building docs

This should allow us to publish our documentation on readthedocs