Zappa needs Sphinx docs on ReadTheDocs.org

[bjinwright]

I aim to make that happen.

[bjinwright]

[jotes]

@bjinwright I think we can close this one 👍

[Miserlou]

Leave this open until we have documentation on how to contribute/compile/publish the docs please! (I don't know..)

[bxm156]

Was thinking, should we just delete the /docs so that user's don't get confused? Sounds like the README is place for documentation.

[aehlke]

@bxm156 I attempted to move in the other direction here #410 so going the other way and deleting /docs sounds good. Do we have anything in /docs that needs to get backported though?

[bxm156]

@aehlke The last notable change to /docs was in Mar 23, 2017. Some of them were last touched a year ago, and they aren't being published on readthedocs.org either.

I don't think there is anything in them that needs backported, I'd say the goto place for documentation has always been the readme. In fact, some of the documentation in /docs is so old that it simply just incorrect for today's version of zappa. @bjinwright did some work on the /docs so he might have some thoughts on this.

[bxm156]

I think there are a few examples for DNS/domain setup in /docs that are linked to from the README. I think we can just integrate them in to the README