Skip to content

Conversation

@stevejpurves
Copy link
Contributor

@stevejpurves stevejpurves commented Dec 4, 2025

This PR simply applies the migration functionality that we already have in Myst migrate to incoming content from xrefs.

We had made a decision not to upgrade previous content automatically within the theme. However, when it comes to xrefs, the lack of this results in a DOM, in an AST that contains basically invalid nodes or nodes that don't conform to the overall AST version being advertised at the root level.Which is particularly bad.

Tested using xrefs to V2 content from a V3 AST.

@changeset-bot
Copy link

changeset-bot bot commented Dec 4, 2025

🦋 Changeset detected

Latest commit: 9ee7fc4

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages
Name Type
myst-cli Patch
mystmd Patch
myst-migrate Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@stevejpurves
Copy link
Contributor Author

The test failure is real, will address if we want to bring this in cc @agoose77

@rowanc1 rowanc1 force-pushed the feat/migrate-external-content branch from 358c383 to 235245a Compare December 8, 2025 16:12
@stevejpurves stevejpurves force-pushed the feat/migrate-external-content branch from 235245a to fb5d6bb Compare December 9, 2025 23:40
@stevejpurves stevejpurves requested a review from fwkoch December 10, 2025 00:07
@stevejpurves
Copy link
Contributor Author

My last commit updated the test snapshot which i expected to fix the failure, but it has not. I am not clear on why.

@stevejpurves stevejpurves requested a review from rowanc1 December 10, 2025 09:08
Comment on lines +218 to +219
"type": "outputs",
"children": [
Copy link
Member

Choose a reason for hiding this comment

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

this looks correct!

Copy link
Member

@rowanc1 rowanc1 left a comment

Choose a reason for hiding this comment

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

I think in the future we might want some better ways to do these test cases.

Right now these are dependent on the docs, which need their own upgrades!

@rowanc1 rowanc1 merged commit c447219 into main Dec 10, 2025
9 checks passed
@rowanc1 rowanc1 deleted the feat/migrate-external-content branch December 10, 2025 15:49
@stefanv
Copy link
Collaborator

stefanv commented Dec 10, 2025

Thanks @rowanc1 for educating me on the upgrade infra on the community call. This now makes a lot of sense, and happy that it provides some future-proofing!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants