Skip to content

rtd with latest mambaforge image for faster building#4476

Merged
tkknight merged 2 commits into
SciTools:mainfrom
bjlittle:docs-update-rtd-infrastructure
Jan 5, 2022
Merged

rtd with latest mambaforge image for faster building#4476
tkknight merged 2 commits into
SciTools:mainfrom
bjlittle:docs-update-rtd-infrastructure

Conversation

@bjlittle

@bjlittle bjlittle commented Jan 4, 2022

Copy link
Copy Markdown
Member

🚀 Pull Request

Description

This PR adopts the latest mambaforge image workflow from RTD to build our documentation, replacing our previous use of the RTD Legacy build specification.

When using the legacy RTD specification, typically I've seen documentation builds taking between 670-730 seconds.

Using the latest mambaforge image, this PR built its documentation in 454 seconds... which is quite an improvement 🚀

(although, this is only a sample of one 😉)

The built documentation associated with this PR can be viewed here, and the raw RTD build log can be viewed here.


Consult Iris pull request check list

Comment thread .readthedocs.yml
@bjlittle

bjlittle commented Jan 4, 2022

Copy link
Copy Markdown
Member Author

@tkknight Also I question our need to support htmlzip and pdf formats of the documentation.

It adds to the built time... and who actually needs or uses these formats? Do we know? 🤔

I've certainly never relied on them... ever.

@tkknight

tkknight commented Jan 4, 2022

Copy link
Copy Markdown
Contributor

I enable the html and pdf options as it was easy to do so and thought some may find it useful. A quick look at other RTD hosted docs didnt show much uptake of it either - so yeah +1 for removing these two build targets.

@tkknight tkknight left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good.

Comment thread .readthedocs.yml
@bjlittle

bjlittle commented Jan 4, 2022

Copy link
Copy Markdown
Member Author

@tkknight Thanks. I'll remove the htmlzip and pdf building, and also add a whatsnew entry

@bjlittle bjlittle force-pushed the docs-update-rtd-infrastructure branch from d98adfd to aff05e0 Compare January 4, 2022 17:32
@bjlittle

bjlittle commented Jan 4, 2022

Copy link
Copy Markdown
Member Author

So we're now down to about 385 seconds to build the docs... which is about half-ish the build time 👍

@bjlittle

bjlittle commented Jan 4, 2022

Copy link
Copy Markdown
Member Author

Back to you @tkknight after a wierd CI barf

@bjlittle

bjlittle commented Jan 4, 2022

Copy link
Copy Markdown
Member Author

... the days of cirrus-ci are numbered

@tkknight tkknight merged commit 4875de6 into SciTools:main Jan 5, 2022
tkknight added a commit to tkknight/iris that referenced this pull request Jan 5, 2022
* main:
  rtd with latest mambaforge image for faster building (SciTools#4476)
  Show acceptable image test results in the docs (SciTools#4392)
  Nc load latlon fix (SciTools#4470)
  update matplotlib links (SciTools#4474)
  Whatsnew for PR 4462 (SciTools#4475)
  Clarify the return type of iris.load (AVD-1899) (SciTools#4462)
  [pre-commit.ci] pre-commit autoupdate (SciTools#4472)
  Updated environment lockfiles (SciTools#4467)
@bjlittle

bjlittle commented Jan 5, 2022

Copy link
Copy Markdown
Member Author

Awesome, thanks @tkknight 😄

@bjlittle bjlittle deleted the docs-update-rtd-infrastructure branch January 5, 2022 10:15
tkknight added a commit to tkknight/iris that referenced this pull request Jan 6, 2022
* main:
  Use partial to make cube pickleable (SciTools#4377)
  Add edit via github method to Iris docs (SciTools#4461)
  Broken cartopy links in docs (SciTools#4464)
  rtd with latest mambaforge image for faster building (SciTools#4476)
  Show acceptable image test results in the docs (SciTools#4392)
  Nc load latlon fix (SciTools#4470)
  update matplotlib links (SciTools#4474)
  Whatsnew for PR 4462 (SciTools#4475)
  Clarify the return type of iris.load (AVD-1899) (SciTools#4462)
  [pre-commit.ci] pre-commit autoupdate (SciTools#4472)
  Updated environment lockfiles (SciTools#4467)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants