[DOC] Move documentation to gh-pages

[oesteban]

Building documentation in RTD generates a lot of noise. We could just submit the documentation built in circle, back to github (https://github.com/oesteban/ghpages-deploy-script).

As for the analytics: https://stackoverflow.com/questions/17207458/how-to-add-google-analytics-tracking-id-to-github-pages

[effigies]

One thing about RTD is the archiving of old versions of the docs. Would we be abandoning that?

[oesteban]

I didn't think of that. Maybe we can just deploy to RTD but skip their automated build?

[effigies]

If we can do that, I'd be up for it.

[oesteban]

Apparently we can't readthedocs/readthedocs.org#1083

[effigies]

Just looked through RTD settings. I believe the noise occurs because we produce PDFs along with our HTML docs, but RTD can't build the same version in parallel, so it errors and re-runs. I will note that the PDFs have some formatting issues (lots of blank pages, author list too long for the title page, and some chunks missing entirely). Do we think that anybody uses these, and that they're worth building?

[oesteban]

In my opinion, PDFs can definitely go away

…

On Sat, May 5, 2018 at 9:56 AM, Chris Markiewicz ***@***.***> wrote: Just looked through RTD settings. I believe the noise occurs because we produce PDFs along with our HTML docs, but RTD can't build the same version in parallel, so it errors and re-runs. I will note that the PDFs have some formatting issues (lots of blank pages, author list too long for the title page, and some chunks missing entirely). Do we think that anybody uses these, and that they're worth building? — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#1105 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAkhxpswcnd99jEcVDcwdH9lUqh2xazMks5tvdnEgaJpZM4TzD5P> .

[effigies]

Okay, turned off. We'll see if that cuts down on the noise. I'll close this for now. Let's reopen if the emails keep coming.

[oesteban]

We are getting memory errors on readthedocs now. I think this is going to be unavoidable.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.