Astro v6.0
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.buildsubdomain when we do
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...Use your smartphone camera to open QR code link. |
To edit notification comments on pull requests, go to your Netlify project configuration.
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. |
@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!)
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).