Skip to content

hotfix: documentation fixes#3358

Merged
daquinteroflex merged 1 commit intodevelopfrom
hotfix/docs-build-fixes
Apr 9, 2026
Merged

hotfix: documentation fixes#3358
daquinteroflex merged 1 commit intodevelopfrom
hotfix/docs-build-fixes

Conversation

@daquinteroflex
Copy link
Copy Markdown
Collaborator

@daquinteroflex daquinteroflex commented Apr 8, 2026

Note

Medium Risk
Moderate risk because it changes Sphinx build configuration, including dynamic autosummary_generate behavior and optional monkey-patching of sphinx.ext.autosummary internals, which could affect doc builds if misconfigured.

Overview
Improves docs build controls by generating autosummary stubs from discovered .rst files during full builds (excluding _autosummary), and adds **/.venv/** to Sphinx exclude_patterns.

Adds optional environment-driven knobs: TIDY3D_DOCS_ONLY to restrict the build to a selected set of .rst pages, and TIDY3D_DOCS_PROFILE_AUTOSUMMARY* to instrument autosummary generation and emit timing diagnostics to stderr.

Updates the SurfaceFieldTimeData docstring to more clearly describe its association with SurfaceFieldTimeMonitor.

Reviewed by Cursor Bugbot for commit d9beeb6. Bugbot is set up for automated code reviews on this repo. Configure here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

Diff Coverage

Diff: origin/develop...HEAD, staged and unstaged changes

No lines with coverage information in this diff.

@daquinteroflex daquinteroflex enabled auto-merge April 9, 2026 08:09
@daquinteroflex daquinteroflex force-pushed the hotfix/docs-build-fixes branch from 2b039df to d9beeb6 Compare April 9, 2026 08:10
@daquinteroflex daquinteroflex disabled auto-merge April 9, 2026 08:10
@daquinteroflex daquinteroflex merged commit b41fba5 into develop Apr 9, 2026
11 checks passed
@daquinteroflex daquinteroflex deleted the hotfix/docs-build-fixes branch April 9, 2026 08:11
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.

1 participant