Skip to content

Conversation

@sarah11918
Copy link
Member

@sarah11918 sarah11918 commented Sep 15, 2025

The branch for your docs for all Astro v6.0 PRs! (Astro Milestone: https://github.com/withastro/astro/milestone/37)

Big changes (that people may still want to review even though they've been merged in) include:

Upgrade guide: https://deploy-preview-12322--astro-docs-2.netlify.app/en/guides/upgrade-to/v6/

Content Collections: Content Collections Guide, astro:content module reference, and Content Loader API reference including explaining the basic format/functions of loaders and how to build them.

Breaking changes (additions, removals, deprecations, stablizings...)

File to edit: v6 upgrade page: src/content/docs/en/guides/upgrade-to/v6.mdx

Use v5 upgrade guide as an example of format:

Template

(More guidance available in the Astro Docs Docs guide to breaking changes)

<SourcePR number="11111" title="PR title"/>

### [changed/removed/added/deprecated]: feature/name/title/description
In Astro v5.x, [ a statement in the past tense about what Astro did/used to do.
e.g.  bundled all assets into several different folders....]

Astro v6.0 [ a statement in the present tense about how Astro works now.
e.g. now bundles all assets into one single folder located in... ]

#### What should I do?
// Active sentences in the imperative (command) tense
// include diff code examples whenever appropriate

e.g. Update... / Remove... / Replace... / Create...

<ReadMore>Learn more about [relevant feature/topic](/en/.../...).</ReadMore>

NB: Even if we decide to change up the format, e.g. organizing by topic vs by kind of change, or other options for easier scanning/readability, then at least providing the content in the same format from last year will give docs the information needed. We can move around/rearrange as needed.

To-do

  • Revert d3883e7 before merging to main
  • Remove v6.docs.astro.build subdomain when we do

@netlify
Copy link

netlify bot commented Sep 15, 2025

Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit 0987548
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/69403731d6d6160008ba351b
😎 Deploy Preview https://deploy-preview-12322--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
Copy link
Contributor

astrobot-houston commented Sep 15, 2025

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
de/tutorial/6-islands/4.mdx Localization changed, will be marked as complete. 🔄️
en/getting-started.mdx Source changed, localizations will be marked as outdated.
en/guides/actions.mdx Source changed, localizations will be marked as outdated.
en/guides/cms/keystatic.mdx Source changed, localizations will be marked as outdated.
en/guides/content-collections.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/microsoft-azure.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/netlify.mdx Source changed, localizations will be marked as outdated.
en/guides/endpoints.mdx Source changed, localizations will be marked as outdated.
en/guides/environment-variables.mdx Source changed, localizations will be marked as outdated.
en/guides/images.mdx Source changed, localizations will be marked as outdated.
en/guides/imports.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/markdoc.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/mdx.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/netlify.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/node.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/vercel.mdx Source changed, localizations will be marked as outdated.
en/guides/internationalization.mdx Source changed, localizations will be marked as outdated.
en/guides/markdown-content.mdx Source changed, localizations will be marked as outdated.
en/guides/media/cloudinary.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-create-react-app.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-gatsby.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nextjs.mdx Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v5.mdx Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v6.mdx Localization added, will be marked as complete.
en/guides/view-transitions.mdx Source changed, localizations will be marked as outdated.
en/install-and-setup.mdx Source changed, localizations will be marked as outdated.
en/reference/adapter-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/api-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/cli-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/configuration-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/content-loader-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/astro-glob-no-match.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/astro-glob-used-outside.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/content-collection-invalid-type.mdx Localization added, will be marked as complete.
en/reference/errors/content-collection-missing-loader.mdx Localization added, will be marked as complete.
en/reference/errors/file-glob-not-supported.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/file-parser-not-found.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/legacy-content-config-error.mdx Localization added, will be marked as complete.
en/reference/errors/live-content-config-error.mdx Source changed, localizations will be marked as outdated.
en/reference/experimental-flags/csp.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/fail-on-prerender-conflict.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/heading-id-compat.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/live-content-collections.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/preserve-scripts-order.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/static-import-meta-env.mdx Source removed, will stop being tracked.
en/reference/image-service-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/integrations-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/legacy-flags.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-assets.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-content.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-transitions.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-zod.mdx Source changed, localizations will be marked as outdated.
en/tutorial/1-setup/1.mdx Source changed, localizations will be marked as outdated.
en/tutorial/6-islands/4.mdx Source changed, localizations will be marked as outdated.
en/upgrade-astro.mdx Source changed, localizations will be marked as outdated.
es/guides/images.mdx Localization changed, will be marked as complete. 🔄️
es/guides/media/cloudinary.mdx Localization changed, will be marked as complete.
es/reference/errors/astro-glob-no-match.mdx Localization removed, will be marked as missing.
es/reference/errors/astro-glob-used-outside.mdx Localization removed, will be marked as missing.
es/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
es/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
es/reference/legacy-flags.mdx Localization changed, will be marked as complete. 🔄️
es/tutorial/5-astro-api/1.mdx Localization changed, will be marked as complete.
es/tutorial/6-islands/4.mdx Localization changed, will be marked as complete. 🔄️
fr/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete. 🔄️
fr/guides/integrations-guide/node.mdx Localization changed, will be marked as complete. 🔄️
fr/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete. 🔄️
fr/guides/view-transitions.mdx Localization changed, will be marked as complete. 🔄️
fr/reference/adapter-reference.mdx Localization changed, will be marked as complete. 🔄️
fr/reference/errors/live-content-config-error.mdx Localization changed, will be marked as complete.
fr/reference/experimental-flags/csp.mdx Localization removed, will be marked as missing. 🔄️
fr/reference/experimental-flags/fail-on-prerender-conflict.mdx Localization removed, will be marked as missing. 🔄️
fr/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
fr/reference/experimental-flags/live-content-collections.mdx Localization removed, will be marked as missing. 🔄️
fr/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
fr/reference/experimental-flags/static-import-meta-env.mdx Localization removed, will be marked as missing.
fr/reference/modules/astro-content.mdx Localization changed, will be marked as complete. 🔄️
it/tutorial/6-islands/4.mdx Localization changed, will be marked as complete. 🔄️
ja/guides/integrations-guide/markdoc.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/mdx.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/node.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete.
ja/guides/migrate-to-astro/from-create-react-app.mdx Localization changed, will be marked as complete.
ja/guides/migrate-to-astro/from-gridsome.mdx Localization changed, will be marked as complete.
ko/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete. 🔄️
ko/guides/integrations-guide/node.mdx Localization changed, will be marked as complete. 🔄️
ko/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete. 🔄️
ko/guides/upgrade-to/v5.mdx Localization changed, will be marked as complete. 🔄️
ko/guides/view-transitions.mdx Localization changed, will be marked as complete. 🔄️
ko/reference/adapter-reference.mdx Localization changed, will be marked as complete. 🔄️
ko/reference/errors/live-content-config-error.mdx Localization changed, will be marked as complete.
ko/reference/experimental-flags/csp.mdx Localization removed, will be marked as missing. 🔄️
ko/reference/experimental-flags/fail-on-prerender-conflict.mdx Localization removed, will be marked as missing. 🔄️
ko/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
ko/reference/experimental-flags/live-content-collections.mdx Localization removed, will be marked as missing. 🔄️
ko/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
ko/reference/experimental-flags/static-import-meta-env.mdx Localization removed, will be marked as missing.
ko/reference/integrations-reference.mdx Localization changed, will be marked as complete.
ko/reference/legacy-flags.mdx Localization changed, will be marked as complete. 🔄️
ko/reference/modules/astro-content.mdx Localization changed, will be marked as complete. 🔄️
pt-br/reference/errors/astro-glob-no-match.mdx Localization removed, will be marked as missing.
pt-br/reference/errors/astro-glob-used-outside.mdx Localization removed, will be marked as missing.
pt-br/reference/legacy-flags.mdx Localization changed, will be marked as complete. 🔄️
pt-br/tutorial/5-astro-api/1.mdx Localization changed, will be marked as complete.
pt-br/tutorial/6-islands/4.mdx Localization changed, will be marked as complete. 🔄️
ru/recipes/i18n.mdx Localization changed, will be marked as complete. 🔄️
ru/reference/errors/astro-glob-no-match.mdx Localization removed, will be marked as missing.
ru/reference/errors/astro-glob-used-outside.mdx Localization removed, will be marked as missing.
ru/reference/errors/mixed-content-data-collection-error.mdx Localization changed, will be marked as complete.
ru/tutorial/6-islands/4.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/guides/integrations-guide/node.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/guides/upgrade-to/v5.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/guides/view-transitions.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/reference/adapter-reference.mdx Localization changed, will be marked as complete.
zh-cn/reference/errors/live-content-config-error.mdx Localization changed, will be marked as complete.
zh-cn/reference/experimental-flags/csp.mdx Localization removed, will be marked as missing. 🔄️
zh-cn/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
zh-cn/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
zh-cn/reference/integrations-reference.mdx Localization changed, will be marked as complete.
zh-cn/reference/legacy-flags.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/reference/modules/astro-content.mdx Localization changed, will be marked as complete. 🔄️
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.

sarah11918 and others added 6 commits September 19, 2025 09:42
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
@github-actions github-actions bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Sep 25, 2025
florian-lefebvre and others added 16 commits September 25, 2025 16:07
Co-authored-by: Matt Kane <m@mk.gg>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Armand Philippot <git@armand.philippot.eu>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Matt Kane <m@mk.gg>
Co-authored-by: Junseong Park <to@jspark.dev>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Louis Escher <66965600+louisescher@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: knj <kenji.tomita1996@gmail.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: knj <70939128+jp-knj@users.noreply.github.com>
Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
florian-lefebvre and others added 12 commits December 4, 2025 16:08
Co-authored-by: Armand Philippot <git@armand.philippot.eu>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Armand Philippot <git@armand.philippot.eu>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: florian-lefebvre <69633530+florian-lefebvre@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
…#12866)

Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
@sarah11918
Copy link
Member Author

@ArmandPhilippot , any chance I can ask you to resolve the conflicts here, since they're all French files (and you probably know best which changes were made anyway!)

@ArmandPhilippot
Copy link
Member

ArmandPhilippot commented Dec 11, 2025

Ah, I think it's because of Zod again. We might encounter the same issue with the Korean PR once merged. 😅 But, yeah, no problem I'm on it!

Edit: We did had the same issue with the Korean PR. If this happens again with other languages, it should be safe to accept all the incoming changes (that's what I did for the FR and KO translations).

ArmandPhilippot and others added 15 commits December 11, 2025 21:26
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: ArmandPhilippot <59021693+ArmandPhilippot@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: ArmandPhilippot <59021693+ArmandPhilippot@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: yanthomasdev <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: bjohansebas <103585995+bjohansebas@users.noreply.github.com>
Co-authored-by: Armand Philippot <59021693+ArmandPhilippot@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: trueberryless <99918022+trueberryless@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

6.0 i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!)

Projects

None yet

Development

Successfully merging this pull request may close these issues.