Skip to content

Doc system notebook execution: WriteIfDifferent. Misc doc fixes#1648

Merged
mpharrigan merged 4 commits intoquantumlib:mainfrom
mpharrigan:2025-05/doc-improvements-1
May 29, 2025
Merged

Doc system notebook execution: WriteIfDifferent. Misc doc fixes#1648
mpharrigan merged 4 commits intoquantumlib:mainfrom
mpharrigan:2025-05/doc-improvements-1

Conversation

@mpharrigan
Copy link
Copy Markdown
Collaborator

Feature: jupyter_autogen.py will only re-write *.ipynb files if there's been a change.
The tool to execute the notebooks is already to set up to only re-execute notebooks if they're out of date. But every time you re-run the first autogen script, it will re-up the modification date and everything will always be re-evaluated, which is expensive.

Misc fixes

  • Use a distinct extension for autotoc.rst.inc, so sphinx doesn't treat it as a page and emit warnings about it
  • include missing TOC entries for notebooks
  • fix flaky notebook assertion by using more idiomatic sympy methods
  • grammar and arg docstring fixes in gf_poly

@mpharrigan mpharrigan merged commit 1087510 into quantumlib:main May 29, 2025
8 checks passed
wjhuggins pushed a commit to wjhuggins/Qualtran that referenced this pull request May 31, 2025
…tumlib#1648)

Feature: `jupyter_autogen.py` will only re-write `*.ipynb` files if
there's been a change.
The tool to execute the notebooks is already to set up to only
re-execute notebooks if they're out of date. But every time you re-run
the first autogen script, it will re-up the modification date and
everything will always be re-evaluated, which is expensive.

Misc fixes
- Use a distinct extension for `autotoc.rst.inc`, so sphinx doesn't
treat it as a page and emit warnings about it
 - include missing TOC entries for notebooks
 - fix flaky notebook assertion by using more idiomatic sympy methods
 - grammar and arg docstring fixes in gf_poly
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants