getStaticPaths flattening entry

yanthomasdev · Aug 30, 2023 · Aug 10, 2023 · Aug 10, 2023 · Aug 10, 2023 · Aug 10, 2023
commit 1717ef375fb277ce8da0524bfc04bbc47b459f14
diff --git a/src/content/docs/en/guides/upgrade-to/v3.mdx b/src/content/docs/en/guides/upgrade-to/v3.mdx
@@ -197,39 +197,6 @@ export default defineConfig({
 });
 ```
 
-### Removed: kebab-case transform for camelCase CSS variables
-
-In Astro v2.x, camelCase CSS variables passed to the `style` attribute were rendered as both camelCase (as written) and kebab-case (kept for backwards compatibility).
-
-Astro 3.0 removes the kebab-case transform for these camelCase CSS variable names, and only the original camelCase CSS variable is rendered.
-
-```astro "my-value"
----
-// src/components/MyAstroComponent.astro
-const myValue = "red"
----
-<!-- input -->
-<div style={{ "--myValue": myValue }}></div>
-
-<!-- output (Astro 2.x) -->
-<div style="--my-value:var(--myValue);--myValue:red"></div>
-<!-- output (Astro 3.0) -->
-<div style="--myValue:red"></div>
-```
-
-#### What should I do?
-
-If you were relying on Astro to transform kebab-case in your styles, update your existing styles to camelCase to prevent missing styles. For example:
-
-```astro del={3} ins={4} title="src/components/MyAstroComponent.astro"
-<style>
-  div {
-   color: var(--my-value);
-   color: var(--myValue);
-  }
-</style>
-```
-
 ### Removed: `class:list` features
 
 In Astro v2.x, the [`class:list` directive](/en/reference/directives-reference/#classlist) used a custom implementation inspired by [`clsx`](https://github.com/lukeed/clsx) with a few extra features like deduplication and `Set` support.
@@ -271,6 +238,55 @@ const { class: className } = Astro.props;
 />
 ```
 
+### Removed: kebab-case transform for camelCase CSS variables
+
+In Astro v2.x, camelCase CSS variables passed to the `style` attribute were rendered as both camelCase (as written) and kebab-case (kept for backwards compatibility).
+
+Astro 3.0 removes the kebab-case transform for these camelCase CSS variable names, and only the original camelCase CSS variable is rendered.
+
+```astro "my-value"
+---
+// src/components/MyAstroComponent.astro
+const myValue = "red"
+---
+<!-- input -->
+<div style={{ "--myValue": myValue }}></div>
+
+<!-- output (Astro 2.x) -->
+<div style="--my-value:var(--myValue);--myValue:red"></div>
+<!-- output (Astro 3.0) -->
+<div style="--myValue:red"></div>
+```
+
+#### What should I do?
+
+If you were relying on Astro to transform kebab-case in your styles, update your existing styles to camelCase to prevent missing styles. For example:
+
+```astro del={3} ins={4} title="src/components/MyAstroComponent.astro"
+<style>
+  div {
+   color: var(--my-value);
+   color: var(--myValue);
+  }
+</style>
+```
+
+### Removed: automatic flattening of `getStaticPaths()`'s return value
+
+:::note[Example maybe?]
+Do we want an example of returning an array of an array, requiring flattening?
+:::
+
+In Astro v2.x, the return value of `getStaticPaths()` was automatically flattened to allow you to return an array of array without errors.
+
+Astro v3.0 removes automatic flattening of `getStaticPaths()`'s result.
+
+#### What should I do?
+
+If you're returning an array of arrays instead of an array of _objects_ (as is expected), `.flatMap` and `.flat` should now be used to ensure that you are returning a flat array.
+
+An [error message indicating that `getStaticPath()`'s return value must be an array of objects](/en/reference/errors/invalid-get-static-paths-entry/#what-went-wrong) will be provided if you need to update your code.
+
 ### Moved: `astro check` is now an external package
 
 In Astro v2.x, [`astro check`](/en/reference/cli-reference/#astro-check) was included in Astro by default and its dependencies were bundled in Astro. This meant a larger package whether or not you ever used `astro check`. This also prevented you from having control over the version of TypeScript and the Astro Language Server to use.
@@ -373,24 +389,6 @@ export default defineConfig({
 })
 ```
 
-### Changed: automatic flattening of `getStaticPaths()`'s return value
-
-:::note[Example needed]
-Find an example of returning an array of an array
-:::
-
-In Astro v2.x, we would magically flatten the result of `getStaticPaths()` automatically for the user, so if you returned an array of array, it would still work
-
-Astro v3.0 we changed this in favour of the user doing it themselves when they need to, in line with how we typically prefer for users to do explicit things.
-
-Removed automatic flattening of getStaticPaths result. .flatMap and .flat should now be used to ensure that you’re returning a flat array.
-
-#### What should I do?
-
-If you're returning an array of arrays instead of an array of object (as you should), please flatten it using .flat(), or if you're using a .map(), use .flatMap() instead
-
-A [error message indicating that `getStaticPath()`'s return value must be an array of objects](/en/reference/errors/invalid-get-static-paths-entry/#what-went-wrong) will be provided if you need to update your code.
-
 ### Changed: default image service to Sharp instead of Squoosh
 
 In Astro v2.x, Squoosh was the default image service.