You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
We can improve our collective productivity if we had a better platform for exchanging WIP snippets. Take this comment from @scks1. I had to separately create the same snippets based on the descriptions to understand the points made in the comment. It would be infinitely faster if we could easily share notebooks.
Since we have per-PR RTD builds, one idea is to create a temp folder under docs, and WIP snippets are saved in a notebook in this folder for each PR. we then periodically clean out this folder or clean it out in each PR.
Thanks for opening this, and sorry for the extra work on #1610. I support the idea. From now on my comments will carry a collapsed snippet for every printed value, and I'll run each snippet as written before I post.
Two notes on docs/temp from the current docs config.
_config.yml sets execute_notebooks: force with a 180 second timeout, and RTD regenerates conf.py from it in pre_build. So each PR build would rerun the temp notebooks against that PR's code. The outputs can't go stale, but each notebook adds its run time to every build of that PR. Snippets on the sample data should stay well under the limit.
_toc.yml lists every page, so a temp notebook outside it would still build but Sphinx would warn that the page isn't in any toctree. An orphan: true front matter cell in each temp notebook might keep it out of the navigation without the warning. I haven't tried that on this build.
A check on main that docs/temp holds nothing but a README could handle the cleanup.
(This comment was written with Árbol, an AI assistant, under my direction.)
Activity
scks1 commentedon Nov 18, 2026
Thanks for opening this, and sorry for the extra work on #1610. I support the idea. From now on my comments will carry a collapsed snippet for every printed value, and I'll run each snippet as written before I post.
Two notes on
docs/tempfrom the current docs config._config.ymlsetsexecute_notebooks: forcewith a 180 second timeout, and RTD regeneratesconf.pyfrom it inpre_build. So each PR build would rerun the temp notebooks against that PR's code. The outputs can't go stale, but each notebook adds its run time to every build of that PR. Snippets on the sample data should stay well under the limit._toc.ymllists every page, so a temp notebook outside it would still build but Sphinx would warn that the page isn't in any toctree. Anorphan: truefront matter cell in each temp notebook might keep it out of the navigation without the warning. I haven't tried that on this build.A check on
mainthatdocs/tempholds nothing but a README could handle the cleanup.(This comment was written with Árbol, an AI assistant, under my direction.)