Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 3 additions & 8 deletions src/content/docs/en/upgrade-astro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,14 @@ banner:
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import Version from '~/components/Version.astro';


This guide covers how to update your version of Astro and related dependencies, how to learn what has changed from one version to the next, and how to understand Astro's versioning system and corresponding documentation updates.

## What has changed?

The latest release of Astro is <Version pkgName="astro" />.

You can find an exhaustive list of all changes in [Astro's changelog](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md), and important instructions for upgrading to each new [major version](#major-changes) in our [upgrade guides](#upgrade-guides).


## Upgrade to the latest version

Update your project's version of Astro and all official integrations to the latest versions with one command using your package manager:
Expand All @@ -43,7 +42,6 @@ Update your project's version of Astro and all official integrations to the late
</Fragment>
</PackageManagerTabs>


### Manual Upgrading

To update Astro and integrations to their current versions manually, use the appropriate command for your package manager.
Expand Down Expand Up @@ -91,7 +89,6 @@ To install a specific [version of Astro](https://www.npmjs.com/package/astro?act
</Fragment>
</PackageManagerTabs>


## Documentation updates

This documentation is updated for each [minor release](#minor-changes) and [major version release](#major-changes). When new features are added, or existing usage changes, the docs will update to reflect the **current behavior of Astro**. If your project is not updated, then you may notice some behaviors do not match the up-to-date documentation.
Expand Down Expand Up @@ -122,7 +119,6 @@ Documentation for older versions of Astro is not maintained, but is available as
- [unmaintained v3.6.3 snapshot](https://docs-git-v3-docs-unmaintained-astrodotbuild.vercel.app/)
- [unmaintained v2.10.15 snapshot](https://deploy-preview-4405--astro-docs-2.netlify.app/en/getting-started/)


## Semantic versioning

Astro attempts to adhere as much as possible to [semantic versioning](https://semver.org/), which is a set of rules developers use to determine how to assign a version number to a release. Semantic version follows a predictable pattern to inform users of the kind of changes they can expect from one version to the next.
Expand All @@ -147,7 +143,6 @@ Patches may be released for reasons such as:

Patch changes also include **most bug fixes**, even in cases where users were taking advantage of existing unintended or undesirable behavior.


### Minor changes

Minor releases primarily introduce new features and improvements that you may wish to try, but require no changes to your code. Some existing features may also be **deprecated** (marked for deletion in a future version while continuing to function) in a minor release, giving you the opportunity to prepare for their eventual removal.
Expand Down Expand Up @@ -205,5 +200,5 @@ The following rules define when Astro may deprecate, drop, or add support for ve
- Security exception: If a security flaw in Node.js that **affects Astro** is disclosed and fixed, the Core team can bump the minimum version in a **minor** release.

### Extended maintenance
The Core team will provide extended maintenance **for security fixes only** for one previous major version. This means that if the current major is `v4.*`, the Core team will back port security fixes and issue a new `v3.*` release.

The Core team will provide extended maintenance **for security fixes only** for one previous major version. This means that if the current major is `v4.*`, the Core team will back port security fixes and issue a new `v3.*` release.