Skip to content

DOC: use RTD for doc builds / hosting #12003

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
jreback opened this issue Jan 9, 2016 · 9 comments
Closed

DOC: use RTD for doc builds / hosting #12003

jreback opened this issue Jan 9, 2016 · 9 comments
Assignees
Labels
Build Library building on various platforms Docs

Comments

@jreback
Copy link
Contributor

jreback commented Jan 9, 2016

now RTD support conda, see here.

for pure-python packages this is quite easy (e.g. @shoyer just added xray support).

We would have to build a conda package on travis. and push to our channel. Which is then pulled from RTD.

@jreback jreback added Build Library building on various platforms Docs Difficulty Intermediate labels Jan 9, 2016
@jreback jreback added this to the Next Major Release milestone Jan 9, 2016
@shoyer
Copy link
Member

shoyer commented Jan 9, 2016

We might even be able to build pandas on RTD -- compiling pandas only takes
a few minutes on my machine, and conda will let us install up to date
dependencies.

On Fri, Jan 8, 2016 at 4:04 PM, Jeff Reback [email protected]
wrote:

now RTD support conda, see here
readthedocs/readthedocs.org#857.

for pure-python packages this is quite easy (e.g. @shoyer
https://github.com/shoyer just added xray support).

We would have to build a conda package on travis. and push to our chanel.
Which is then pulled from RTD.


Reply to this email directly or view it on GitHub
#12003.

@jreback
Copy link
Contributor Author

jreback commented Jan 9, 2016

I wasn't aware that you could actually compile things on RTD, really?

@shoyer
Copy link
Member

shoyer commented Jan 9, 2016

Yep, it runs setup.py. You just can't compile dependencies -- but now we'll be able to install matplotlib, scipy, pytables, etc with conda.

On Fri, Jan 8, 2016 at 4:13 PM, Jeff Reback [email protected]
wrote:

I wasn't aware that you could actually compile things on RTD, really?

Reply to this email directly or view it on GitHub:
#12003 (comment)

@jreback
Copy link
Contributor Author

jreback commented Jan 9, 2016

oh if that's the case, then great!

your next project!

@jbrockmendel
Copy link
Member

@datapythonista is this actionable/desirable?

@datapythonista
Copy link
Member

I'm not the right person to tell, I don't understand our build system so well. But seems like this could make our lives easier, so I'll do some research while working on the documentation refactoring.

@datapythonista datapythonista self-assigned this Jul 12, 2018
@jorisvandenbossche
Copy link
Member

I think the main problem is that our docs take a long time to build (on travis often between 40 and 50 minutes), while https://docs.readthedocs.io/en/latest/builds.html mentions a limit of 15 min (I thought it was longer, but that is in any case way too short)

@shoyer
Copy link
Member

shoyer commented Jul 13, 2018 via email

@jorisvandenbossche
Copy link
Member

OK, let's close this then.

@jorisvandenbossche jorisvandenbossche removed this from the Contributions Welcome milestone Jul 13, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Build Library building on various platforms Docs
Projects
None yet
Development

No branches or pull requests

5 participants