Skip to content

[next]: add migration section for removal of internal exports#12816

Merged
sarah11918 merged 8 commits into
withastro:v6from
trueberryless:tbl-14844-cleanup-actions-public-api
Dec 2, 2025
Merged

[next]: add migration section for removal of internal exports#12816
sarah11918 merged 8 commits into
withastro:v6from
trueberryless:tbl-14844-cleanup-actions-public-api

Conversation

@trueberryless

@trueberryless trueberryless commented Dec 1, 2025

Copy link
Copy Markdown
Contributor

Description (required)

This PR adds a section to the v6 migration guide regarding refactor: cleanup public actions API #14844 .

I listed all removed utilities (classes, functions and types) for clarity. I'm not sure if this is a good approach, as when people search for these terms in the future, they'll be able to find them here, alto they are not documented anywhere (because they got removed).

I did not come up with a better example to demonstrate a removal and I was so cheeky to include myself in there. Feel free to suggest a more appropriate example 🙌

Related issues & labels (optional)

For Astro version: 6.x. See astro PR #14844.

Pinging @florian-lefebvre for review (no rush!).

@netlify

netlify Bot commented Dec 1, 2025

Copy link
Copy Markdown

Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 8111f64
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/692ee4dc16a6770008995843
😎 Deploy Preview https://deploy-preview-12816--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@astrobot-houston

astrobot-houston commented Dec 1, 2025

Copy link
Copy Markdown
Contributor

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/guides/upgrade-to/v6.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

Comment thread src/content/docs/en/guides/upgrade-to/v6.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade-to/v6.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade-to/v6.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade-to/v6.mdx Outdated

@sarah11918 sarah11918 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks for providing these docs @trueberryless , and really nice editing job @florian-lefebvre ! I just left a couple of thoughts here.

(And note: the order of these entries got a little bit messed up. I've been trying to keep the core breaking changes FIRST, and then the ones that are likely to affect fewer people (e.g. Adapter API, Integration API) at the end, with their API in parentheses.

So ideally I'd probably order this one higher, before any of the Integration/Adapter ones. But, there are more that will need to be reordered, so not a huge deal to do that in this PR. Ideally though, these should not just "go to the bottom of the list" but go in "relevance" order, so that the average person sees the more basic stuff first (and can maybe stop reading at some point).

Comment thread src/content/docs/en/guides/upgrade-to/v6.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade-to/v6.mdx Outdated
@trueberryless

Copy link
Copy Markdown
Contributor Author

Thanks for the reviews and amazing suggestions, Sarah and Florian!

I really like the What should I do? example now. The new section is now above all integrations/adapters sections, if the order needs to be adapted later (eg even further up), I think we can fine tune it in the v6 docs PR. 🙌

@sarah11918 sarah11918 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM! Thanks both!

@sarah11918 sarah11918 added the 6.0 label Dec 2, 2025
@sarah11918 sarah11918 added this to the v6.0.0 docs milestone Dec 2, 2025
@sarah11918 sarah11918 merged commit 8761f6d into withastro:v6 Dec 2, 2025
10 checks passed
@trueberryless trueberryless deleted the tbl-14844-cleanup-actions-public-api branch December 2, 2025 19:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants