From b56c0cbda18821ede8eb9f40a5f485c539ce15ac Mon Sep 17 00:00:00 2001 From: "Fred K. Schott" Date: Wed, 11 Aug 2021 15:48:30 -0700 Subject: [PATCH] improve release notes for filebased routing --- .changeset/light-ads-grin.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) 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 + + + +