docs: regenerate API refs with mdxify >=0.2.45 (drop empty stubs)#22344
Merged
Conversation
zzstoatzz
force-pushed
the
docs/mdxify-integrations-empty-stubs
branch
from
June 22, 2026 18:37
795dc11 to
7b21db1
Compare
zzstoatzz
changed the title
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
zzstoatzz
force-pushed
the
docs/mdxify-integrations-empty-stubs
branch
from
June 22, 2026 19:05
7b21db1 to
7a8af13
Compare
zzstoatzz
changed the title
zzstoatzz
marked this pull request as ready for review
June 22, 2026 19:30
zzstoatzz
requested review from
chrisguidry,
cicdw and
desertaxle
as code owners
June 22, 2026 19:30
zzstoatzz
force-pushed
the
docs/mdxify-integrations-empty-stubs
branch
2 times, most recently
from
June 22, 2026 19:48
26d34ac to
b3690df
Compare
zzstoatzz
changed the title
Rebased onto #22348 (databricks docstring cleanup). Bumps mdxify to >=0.2.45 across the core justfile/scripts and all 18 integration justfiles, and fully regenerates the API references. Removes empty-module stub pages and their nav entries. Regenerating also brings the prefect-databricks api-ref docs in line with the rewritten source docstrings from #22348 (which updated the source but did not regenerate the docs), and applies its prefect_databricks.models exclusion. prefect-gcp: dropped --no-update-nav so its nav regenerates like every other integration (its hand-maintained nav had drifted). Verified: `mint broken-links` clean, 0 dead links / 0 orphans. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
zzstoatzz
force-pushed
the
docs/mdxify-integrations-empty-stubs
branch
from
June 22, 2026 20:27
b3690df to
cb70c4d
Compare
desertaxle
approved these changes
Jun 22, 2026
4 tasks
br413
pushed a commit
to br413/prefect
that referenced
this pull request
Jul 14, 2026
…efectHQ#22344) Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Companion to #22339 (core SDK, merged). Bumps mdxify to
>=0.2.45across the corejustfile/scripts/generate_api_ref.pyand all 18 integrationjustfiles, and does a full regeneration. Removes 35 empty-module stub pages across 8 integrations + their nav entries.mdxify 0.2.45 does no docstring escaping — the earlier brace-escaping attempts were reverted (zzstoatzz/mdxify#47) as the wrong layer. Where a regenerated docstring didn't render as valid MDX, the fix is in the source docstring, not an escaping pass:
prefect-databricksflows.py: wrapped bare JSON dict examples in backticks (inline code).prefect-databricksjobs.py: collapsed multi-line inline-code spans onto a single line (MDX only treats single-line backtick spans as code).Verified:
npx mint broken-links→ "success no broken links found", 0 orphans.Notable
--no-update-navfrom its justfile so its nav regenerates like every other integration (its hand-maintained nav had drifted to a removedexperimental.*module path).🤖 Generated with Claude Code