Skip to content

Commit a409a05

Browse files
simplify experimental flags section (#12587)
Co-authored-by: florian-lefebvre <69633530+florian-lefebvre@users.noreply.github.com>
1 parent b7d1636 commit a409a05

File tree

1 file changed

+13
-15
lines changed
  • src/content/docs/en/guides/upgrade-to

1 file changed

+13
-15
lines changed

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

Lines changed: 13 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -405,36 +405,34 @@ export const server = {
405405

406406
### Experimental Flags
407407

408-
The following experimental flags have been removed in Astro v6.0 and these features are available for use:
409-
410-
- `thing 1`
411-
412-
Additionally, the following experimental flags have been removed and **are now the default or recommended behavior in Astro v6.0**.
413-
414-
- `experimental.preserveScriptOrder` (See below for breaking changes to [default `<script>` and `<style>` behavior](#changed-script-and-style-tags-are-rendered-in-the-order-they-are-defined).)
415-
- `experimental.staticImportMetaEnv` (See below for breaking changes to [`import.meta.env`](#changed-importmetaenv-values-are-always-inlined).)
416-
417-
The following experimental flags have been removed and **their corresponding features are not part of Astro v6.0**.
418-
419-
- `thing 2`
408+
Experimental flags allow you to opt in to features while they are in early development. Astro may also use experimental flags to test breaking changes to default behavior. The following experimental flags have been removed in Astro 6.0 and are now stable, or the new default behavior.
420409

421410
Remove these experimental flags from your Astro config if you were previously using them:
422411

423-
```js del={5-7} title="astro.config.mjs"
412+
```js del={5-8} title="astro.config.mjs"
424413
import { defineConfig } from 'astro/config';
425414

426415
export default defineConfig({
427416
experimental: {
417+
liveContentCollections: true,
428418
preserveScriptOrder: true,
429419
staticImportMetaEnv: true,
430420
headingIdCompat: true,
431421
},
432422
})
433423
```
434424

435-
These features are all available by default in Astro v5.0.
425+
#### Experimental features now stable:
426+
427+
- `liveContentCollections` (See the updated [content collections docs](/en/guides/content-collections/) to learn more about live collections.)
428+
429+
#### New default or recommended behavior:
430+
431+
- `preserveScriptOrder` (See below for breaking changes to [default `<script>` and `<style>` behavior](#changed-script-and-style-tags-are-rendered-in-the-order-they-are-defined).)
432+
- `staticImportMetaEnv` (See below for breaking changes to [`import.meta.env`](#changed-importmetaenv-values-are-always-inlined).)
433+
- `headingIdCompat` (See below for breaking changes to [Markdown heading ID generation](#changed-markdown-heading-id-generation).)
436434

437-
<ReadMore>Read about these exciting features and more in [the v6.0 Blog post](https://astro.build/blog/astro-6/).</ReadMore>
435+
<ReadMore>Read about exciting new features and more in [the v6.0 Blog post](https://astro.build/blog/astro-6/).</ReadMore>
438436

439437

440438
## Changed Defaults

0 commit comments

Comments
 (0)