Add a rendered version of the documentation to Read the Docs

[ericholscher]

This allows folks to browse the contents in a nicer way,
including with navigation and search.

I made the project, but would be happy to hand over the keys
to folks on the Swift team if you're interested.

You could also CNAME docs.swift.org to this,
and use that as a canonical source if you were interested.

You can see the rendered version here: http://apple-swift.readthedocs.org/en/latest/contents.html

I also added a branch that renders it using our own theme, which I find to be more useful. We could help add some swift branding to it, if you're interested in using it: http://apple-swift.readthedocs.org/en/readthedocs-theme/index.html -- It makes the contents much more readable on mobile as well.

[al45tair]

The Read the Docs theme version is really good IMO.

[johnantoni]

+1

prefer your theme #44 much more easier on the eyes and scannable

[CodaFi]

First of all, thank you all for the discussion and for bringing this issue to our attention. I apologize that it took so long for us to get around to reviewing this change. We feel that though readthedocs provides value, it may serve as a distraction from documentation provided by Apple - ultimately, that's the one we want to push users towards. Nevertheless, rehosting our docs with such nice formatting and a friendly interface is a hugely useful thing to have and we may want to put a link on, say, swift.org somewhere instead. With that, I must close this issue.

Please email swift-dev with this, though. I'm sure the community would love to see this.