docs icon indicating copy to clipboard operation
docs copied to clipboard

Astro v6.0

Open sarah11918 opened this issue 3 months ago • 4 comments

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:

  • Deployed: https://docs.astro.build/en/guides/upgrade-to/v5/
  • Source file: src/content/docs/en/guides/upgrade-to/v5.mdx

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 d3883e7e4d8961c41ea895cb2e64335948c34f81 before merging to main
  • [ ] Remove v6.docs.astro.build subdomain when we do

sarah11918 avatar Sep 15 '25 22:09 sarah11918

Deploy Preview for astro-docs-2 ready!

Name Link
Latest commit 98f6dbf7a9176570d5a347cb3d1dc49c8f12c4af
Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/69459b0b2bb315000812126b
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.

netlify[bot] avatar Sep 15 '25 22:09 netlify[bot]

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/cloudcannon.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/sessions.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/error-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/csp-not-enabled.mdx Source changed, localizations will be marked as outdated.
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/get-entry-deprecation-error.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/get-static-paths-invalid-route-param.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-content-entry-data-error.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-content-entry-frontmatter-error.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-glob.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-i18n-middleware-configuration.mdx Localization added, will be marked as complete.
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/errors/prerender-route-conflict.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/unavailable-astro-global.mdx Localization added, will be marked as complete.
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/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/reference/session-driver-reference.mdx Localization added, will be marked as complete.
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.

astrobot-houston avatar Sep 15 '25 22:09 astrobot-houston

@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!)

sarah11918 avatar Dec 11 '25 20:12 sarah11918

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 avatar Dec 11 '25 20:12 ArmandPhilippot