Skip to content

Conversation

@tkknight
Copy link
Contributor

🚀 Pull Request

Description

Small quality of life change when working on improving the Iris documentation (developers use only). I would typically comment out the iris docs sphinx extensions when editing the documentation and skip the gallery builds to allow for faster builds. I would still of course do a complete clean and full build as a final test.

The PR introduces to new make targets for the Iris docs:

  • make html-noapi. This will skip the API doc creation
  • make html-quick. This will skip the API doc creation and also skip the gallery creation.

Consult Iris pull request check list

@rcomer
Copy link
Member

rcomer commented Sep 21, 2021

Nice - I often build the docs just to check I haven't messed up the whatsnew syntax! I had found the html-noplot option, but this will be better 😃

Copy link
Member

@bjlittle bjlittle left a comment

Choose a reason for hiding this comment

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

@tkknight Nice one 👍

Fancy adding a whatsnew entry?

@bjlittle bjlittle self-assigned this Sep 21, 2021
@bjlittle bjlittle merged commit 63c1220 into SciTools:main Sep 21, 2021
tkknight added a commit to tkknight/iris that referenced this pull request Sep 22, 2021
* main: (94 commits)
  added support for make html-noapi and html-quick for the docs build (SciTools#4333)
  Refactor some netcdf save code (SciTools#4301)
  [pre-commit.ci] pre-commit autoupdate (SciTools#4329)
  Update to loading docs to cover absence of 'or' for constraints (SciTools#4321)
  update latest.rst.template (SciTools#4323)
  stable cartopy feature download (SciTools#4328)
  Skip TestConstrainedLoad if data missing (SciTools#4319)
  Add 'Good First Issue' label to reasons an issue doesn't go stale (SciTools#4317)
  Gallery: simplify quiver example (SciTools#4120)
  Improve styling in a minor way in docs (SciTools#4314)
  bump version (SciTools#4310)
  Made clear we only test on Linux. (SciTools#4309)
  Updated environment lockfiles (SciTools#4308)
  Include Discussions in Getting Involved. (SciTools#4307)
  Fixed text to show as link. (SciTools#4305)
  [pre-commit.ci] pre-commit autoupdate (SciTools#4299)
  Updated environment lockfiles (SciTools#4298)
  cartopy feature download (SciTools#4304)
  Mesh Loading (AVD-1813) (SciTools#4262)
  reset whatsnew latest (SciTools#4288)
  ...
@tkknight tkknight deleted the make_skip branch December 20, 2021 16:03
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.

3 participants