Skip to content

Commit 1b81394

Browse files
pragmaticpatLekoArtsgatsbybot
authored
chore(docs): Update Gatsby framework version support information (#33825)
Co-authored-by: Lennart <[email protected]> Co-authored-by: gatsbybot <[email protected]>
1 parent 651ab47 commit 1b81394

File tree

3 files changed

+40
-30
lines changed

3 files changed

+40
-30
lines changed

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -147,6 +147,8 @@ We welcome suggestions for improving our docs. See the [“how to contribute”]
147147

148148
Wondering what we've shipped recently? Check out our [release notes](https://www.gatsbyjs.com/docs/reference/release-notes) for key highlights, performance improvements, new features, and notable bugfixes.
149149

150+
Also, read our [documentation on version support](https://www.gatsbyjs.com/docs/reference/release-notes/gatsby-version-support/) to understand our plans for each version of Gatsby.
151+
150152
## 💼 Migration Guides
151153

152154
Already have a Gatsby site? These handy guides will help you add the improvements of Gatsby v4 to your site without starting from scratch!
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
title: Gatsby Framework Version Support
3+
---
4+
5+
## Introduction
6+
7+
This page illustrates the support plans for the major versions of Gatsby. This allows you to effectively plan your Gatsby framework upgrades.
8+
9+
Generally, you can expect **1 major version per calendar year**. Although, there may be more than 1 major per year when a necessary evolution of Gatsby requires significant breaking change.
10+
11+
## Release and support schedule
12+
13+
Note: Future time ranges are listed when a specific target date is not yet determined.
14+
15+
| Version | Status | As Of | Until |
16+
| ------- | ----------------------------- | ---------------- | --------------- |
17+
| 4 | Active | October 21, 2021 | Summer 2022 |
18+
| 3 | Maintenance Long-term support | October 21, 2021 | Summer 2022 |
19+
| 2 | Maintenance Long-term support | March 3, 2021 | January 1, 2022 |
20+
21+
## Terminology
22+
23+
- **Critical Patch** - A critical patch addresses an issue that prevents the Gatsby framework from delivering intended user value under typical conditions. Other items, such as minor bug fixes and new features are not considered "critical patches" to Gatsby.
24+
25+
- **Active Long-Term Support** - Receives priority attention from the core maintainers of Gatsby. New features to Gatsby are only available in the Active Long-Term Supported version.
26+
27+
- **Maintenance Long-term Support** - Receives critical patches, but does not receive new features.
28+
29+
- **Unsupported** - This version of Gatsby no longer receives official support of any kind.
30+
31+
## What does this mean for users of the Gatsby framework?
32+
33+
- To receive the newest enhancements and bug fixes, ensure that you've [migrated to Gatsby Version 4](/docs/reference/release-notes/migrating-from-v3-to-v4/) by **January 1, 2022**
34+
- Continue reporting any issues as you typically would, either using [support](https://www.gatsbyjs.com/support/) on Gatsbyjs.com, or by [opening an issues](https://github.com/gatsbyjs/gatsby/issues/new/choose) in our GitHub repository.
35+
36+
## What does this mean for Gatsby Cloud?
37+
38+
Your Gatsby-powered sites will continue to run as they do today in Gatsby Cloud. However, as enhancements are delivered within Gatsby Cloud and the Gatsby framework, you may need to upgrade your site(s) in order to take advantage of those features and performance enhancements.

docs/docs/reference/release-notes/v2-maintenance-plan.md

Lines changed: 0 additions & 30 deletions
This file was deleted.

0 commit comments

Comments
 (0)