-
Notifications
You must be signed in to change notification settings - Fork 10.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore(docs): Release Notes for 4.22 (#36464)
* chore(docs): Release Notes for 4.22 * Update index.md * Add release notes from git history, open RFCs highlight * Add contributors * Update index.md Co-authored-by: Josh <[email protected]> Co-authored-by: Dustin Schau <[email protected]>
- Loading branch information
3 people
authored
Aug 30, 2022
1 parent
5302b7a
commit 341bd6d
Showing
1 changed file
with
117 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,117 @@ | ||
| --- | ||
| date: "2022-08-30" | ||
| version: "4.22.0" | ||
| title: "v4.22 Release Notes" | ||
| --- | ||
|
|
||
| Welcome to `[email protected]` release (August 2022 #3) | ||
|
|
||
| Key highlights of this release: | ||
|
|
||
| - [Open RFCs](#open-rfcs) | ||
|
|
||
| Also check out [notable bugfixes](#notable-bugfixes--improvements). | ||
|
|
||
| **Bleeding Edge:** Want to try new features as soon as possible? Install `gatsby@next` and let us know if you have any [issues](https://github.com/gatsbyjs/gatsby/issues). | ||
|
|
||
| [Previous release notes](/docs/reference/release-notes/v4.21) | ||
|
|
||
| [Full changelog][full-changelog] | ||
|
|
||
| --- | ||
|
|
||
| ## Open RFCs | ||
|
|
||
| ### Slices API | ||
|
|
||
| We are adding a new API that we are calling “Slices”. By using a new `<Slice />` React component in combination with a `src/slices` directory or `createSlice` API for common UI features, Gatsby will be able to build and deploy individual pieces of your site that had content changes, not entire pages. | ||
|
|
||
| To create a slice, simply: | ||
|
|
||
| 1. Create the slice by adding a `slices/footer.js` file, or using the `createPages` API action: | ||
|
|
||
| ```js | ||
| actions.createSlice({ | ||
| id: `footer`, | ||
| component: require.resolve(`./src/components/footer.js`), | ||
| }) | ||
| ``` | ||
|
|
||
| 2. Add a `<Slice />` component on your site, providing an `alias` string prop, where `alias` is either name of the file (in our case, `footer`). Any additional props passed will be handed down to the underlying component. | ||
|
|
||
| ```jsx | ||
| return ( | ||
| <> | ||
| <Header className="my-header" /> | ||
| {children} | ||
| <Slice alias="footer" /> | ||
| </> | ||
| ) | ||
| ``` | ||
|
|
||
| To read more, head over to [RFC: Slices API](https://github.com/gatsbyjs/gatsby/discussions/36339). We appreciate any feedback there. | ||
|
|
||
| ### Changes in `sort` and aggregation fields in Gatsby GraphQL Schema | ||
|
|
||
| We are proposing Breaking Changes for the next major version of Gatsby to our GraphQL API. The goal of this change is increasing performance and reducing resource usage of builds. Proposed changes impact `sort` and aggregation fields (`group`, `min`, `max`, `sum`, `distinct`). | ||
|
|
||
| Basic example of proposed change: | ||
|
|
||
| Current: | ||
|
|
||
| ```graphql | ||
| { | ||
| allMarkdownRemark(sort: { fields: [frontmatter___date], order: DESC }) { | ||
| nodes { | ||
| ...fields | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| Proposed: | ||
|
|
||
| ```jsx | ||
| { | ||
| allMarkdownRemark(sort: { frontmatter: { date: DESC } }) { | ||
| nodes { | ||
| ...fields | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| To read more, head over to [RFC: Change to sort and aggregation fields API](https://github.com/gatsbyjs/gatsby/discussions/36242). We appreciate any feedback there. | ||
|
|
||
| ## Notable bugfixes, improvements, & changes | ||
|
|
||
| - `gatsby` | ||
| - Add option to emit TypeScript types during `gatsby build`, via [PR #36405](https://github.com/gatsbyjs/gatsby/pull/36405) | ||
| - Fix issue where TypeScript retry mechanism would cause Windows to crash Gatsby while Parcel cache is open, via [PR #36377](https://github.com/gatsbyjs/gatsby/pull/36377) | ||
| - Prevent errors when the `Head` component has a root text node, via [PR #36402](https://github.com/gatsbyjs/gatsby/pull/36402) | ||
| - `gatsby-cli`: Preserve verbosity in spawn child processes, via [PR #36399](https://github.com/gatsbyjs/gatsby/pull/36399) | ||
| - `gatsby-source-graphql`: we have "soft deprecated" this package in favor of other, CMS-specific source plugins | ||
| - _Note:_ You can continue to use this plugin for small sites or proof-of-concepts, but for larger sites backed by one or multiple CMSs we recommend using the official source plugin | ||
| - [Read more on the README about the decision](https://gatsbyjs.com/plugins/gatsby-source-graphql) as well as the [pull request](https://github.com/gatsbyjs/gatsby/pull/36469) | ||
| - `gatsby-plugin-mdx` | ||
| - Fix issue with plugin options from e.g. gatsby-remark-images not getting passed through, via [PR #36387](https://github.com/gatsbyjs/gatsby/pull/36387) | ||
| - Fix issue with too long chunk names, via [PR #36387](https://github.com/gatsbyjs/gatsby/pull/36387) | ||
| - `gatsby-plugin-image`: Fix bug that prevents `onLoad` being called on first load, via [PR #36375](https://github.com/gatsbyjs/gatsby/pull/36375) | ||
|
|
||
| ## Contributors | ||
|
|
||
| A big **Thank You** to [our community who contributed][full-changelog] to this release 💜 | ||
|
|
||
| - [alexlouden](https://github.com/alexlouden): fix(gatsby-plugin-react-helmet): Typo in `onPreInit` warning [PR #36419](https://github.com/gatsbyjs/gatsby/pull/36419) | ||
| - [axe312ger](https://github.com/axe312ger): chore(docs): MDX v2 [PR #35893](https://github.com/gatsbyjs/gatsby/pull/35893) | ||
| - [mashehu](https://github.com/mashehu): chore(docs): fix incorrect closing tag in tutorial [PR #36459](https://github.com/gatsbyjs/gatsby/pull/36459) | ||
| - [endymion1818](https://github.com/endymion1818): feat(docs): add webiny to headless cms list [PR #36388](https://github.com/gatsbyjs/gatsby/pull/36388) | ||
| - [that1matt](https://github.com/that1matt): fix(gatsby-source-graphql): add dataLoaderOptions validation to gatsby-source-graphql [PR #36112](https://github.com/gatsbyjs/gatsby/pull/36112) | ||
| - [taiga39](https://github.com/taiga39): chore(docs): Fix some typos [PR #36431](https://github.com/gatsbyjs/gatsby/pull/36431) | ||
| - [TalAter](https://github.com/TalAter): chore(docs): Update plugin count in part 3 of the tutorial [PR #36455](https://github.com/gatsbyjs/gatsby/pull/36455) | ||
| - [Kornil](https://github.com/Kornil) | ||
| - chore(gatsby): convert babel-loaders to typescript [PR #36318](https://github.com/gatsbyjs/gatsby/pull/36318) | ||
| - chore(gatsby): convert sanitize-node to typescript [PR #36327](https://github.com/gatsbyjs/gatsby/pull/36327) | ||
| - [ChefYeum](https://github.com/ChefYeum): chore(docs): Fix page link to page 6 of remark tutorial [PR #36437](https://github.com/gatsbyjs/gatsby/pull/36437) | ||
|
|
||
| [full-changelog]: https://github.com/gatsbyjs/gatsby/compare/[email protected]@4.22.0 |