Major rewrite to Docs (do not merge this, only for review)

[dfordivam]

• re-structured the existing documentation
• added a lot more content and some empty headings

[dfordivam]

@mightybyte fixed this..

There will be many more issues, so I think it would be better to review the docs with a proper preview.

Perhaps we can merge these on a separate branch and preview on the readthedocs.io
or we can merge these over master and then fix issues.

[ElvishJerricco]

Thanks for this! I didn't look at reflex_docs.rst or reflex_dom_docs.rst, so this is only a partial review. But this is great!

[dfordivam]

It seems there are two versions of readthedocs.io docs

This central repo creates the docs here
http://reflex-frp.readthedocs.io/en/latest/

And my own repo is also creating docs here
http://docs.reflex-frp.org/en/latest/

@ryantrinkle we have to fix this.. ie point the reflex-frp.org one to fetch the docs from the central repo

But meanwhile this PR is available on
http://docs.reflex-frp.org/en/latest/

[srid]

Holly crap! When did reflex get documentation?!?!

https://news.ycombinator.com/item?id=16800643

[dfordivam]

Hmm.. the documentation has been for a while now. But I think now it is in a shape to advertise it on the README, other places...

What reflex really need next is an home page!

[ryantrinkle]

@dfordivam reflex-frp.org is now up :) Let's find a way to integrate your docs!

[ryantrinkle]

Also, @ElvishJerricco @dfordivam, should I merge this?

[ElvishJerricco]

I raised a few concerns in comments when this was first opened. I'd prefer to see those fixed before merging this, especially the bits about delay and cabal.

[dfordivam]

@ryantrinkle the http://reflex-frp.org/ page points to a section of docs which doesn't exist.
http://reflex-frp.readthedocs.io/en/latest/architecture.html#overview-of-reflex-basics

It seems the docs are being built from my repo, so it already has this PR
I have nothing to add to the delay point raised by ElvishJerricco, so it is ready to be merged from my side...

[dfordivam]

This file has been added to reflex-examples repo reflex-frp/reflex-examples#17
So it will not be a part of docs here.

[dfordivam]

Hi All!

I have done some fixes and added information about Obelisk to the docs. (See my last commit for details)
This PR is currently live at http://docs.reflex-frp.org/en/latest/index.html

This PR is quite old now, and will be better merged after taking care of #37 , by creating a fresh PR on top of that.