summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGravatar Fred K. Schott <fkschott@gmail.com> 2021-08-11 15:48:30 -0700
committerGravatar Fred K. Schott <fkschott@gmail.com> 2021-08-11 15:48:30 -0700
commitb56c0cbda18821ede8eb9f40a5f485c539ce15ac (patch)
tree47cd6c5c78c2a65b565ad75a4469a06855d52d6a
parent3ba2930fbd16abb23dae0dc05f9b651e948ce187 (diff)
downloadastro-b56c0cbda18821ede8eb9f40a5f485c539ce15ac.tar.gz
astro-b56c0cbda18821ede8eb9f40a5f485c539ce15ac.tar.zst
astro-b56c0cbda18821ede8eb9f40a5f485c539ce15ac.zip
improve release notes for filebased routing
Diffstat (limited to '')
-rw-r--r--.changeset/light-ads-grin.md18
1 files changed, 17 insertions, 1 deletions
diff --git a/.changeset/light-ads-grin.md b/.changeset/light-ads-grin.md
index acd18e09e..0774ccb68 100644
--- a/.changeset/light-ads-grin.md
+++ b/.changeset/light-ads-grin.md
@@ -2,4 +2,20 @@
'astro': minor
---
-Replace collections API with new file-based routing support
+**[BREAKING]** Replace the Collections API with new file-based routing.
+
+This is a breaking change which impacts collections, pagination, and RSS support.
+Runtime warnings have been added to help you migrate old code to the new API.
+If you have trouble upgrading, reach out on https://astro.build/chat
+
+This change was made due to confusion around our Collection API, which many users found difficult to use. The new file-based routing approach should feel more familiar to anyone who has used Next.js or SvelteKit.
+
+Documentation added:
+- https://astro-docs-git-main-pikapkg.vercel.app/core-concepts/routing
+- https://astro-docs-git-main-pikapkg.vercel.app/guides/pagination
+- https://astro-docs-git-main-pikapkg.vercel.app/guides/rss
+- https://astro-docs-git-main-pikapkg.vercel.app/reference/api-reference#getstaticpaths
+
+
+
+