Skip to content
Draft
Show file tree
Hide file tree
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
2 changes: 2 additions & 0 deletions docs/0-getting-started/01-introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,8 @@ final readonly class BookController

And a lot more.

Tempest embraces the latest PHP features and only supports the latest stable major version of the framework. We don't offer long-term support (LTS) releases, but provide Rector suites to make upgrading between major versions easier. Learn more about our [versioning and support policy](../5-extra-topics/01-versions-and-support.md) .

### Getting out of your way

A core part of Tempest's philosophy is that it wants to "get out of your way" as best as possible. For starters, Tempest is designed to structure your project code however you want, without making any assumptions or forcing conventions on you. You can prefer a classic MVC application, DDD or hexagonal design, microservices, or something else; Tempest works with any project structure out of the box without any configuration.
Expand Down
68 changes: 68 additions & 0 deletions docs/5-extra-topics/01-versions-and-support.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Versions & Support

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# Versions & Support
# Versions & support


Tempest follows a straightforward versioning and support policy. We focus our maintenance efforts on the latest stable major version, embrace modern PHP features, and provide automated upgrade paths to help projects stay up to date.

## Supported versions

Only the latest stable major version of Tempest is officially supported.

| Version | Status | Support |
|---|---|---|
| 4.x | Upcoming | Not yet released |
| 3.x | Current | Supported |
| 2.x and older | End of life | Unsupported |

When a new major version is released, the previous major version reaches its end of life and no longer receives official support.

This means that when Tempest 4.x is released, Tempest 3.x will no longer be supported.

## Long-term support

Tempest does not offer long-term support (LTS) releases.

Instead of maintaining multiple major versions simultaneously, we focus our efforts on improving and maintaining the latest version of the framework.

This allows us to move the framework forward without the maintenance burden of supporting older versions indefinitely.

We encourage developers to stay up to date with the latest stable major version.

## PHP version support

Tempest embraces modern PHP and aims to make full use of the language's latest features and improvements.

**The latest major version of Tempest targets the latest stable version of PHP.** We prioritize moving the framework forward rather than maintaining compatibility with older PHP versions.

As a result, upgrading to a new major version of Tempest may also require upgrading your PHP version.

We believe staying current with PHP allows us to build a simpler, more expressive, and more maintainable framework.

You can find the exact PHP requirements for your version of Tempest in the installation documentation.

## What does support include?

Supported versions may receive:

- Bug fixes
- Security fixes
- Compatibility updates
- General maintenance and improvements

Unsupported versions no longer receive official maintenance, including bug fixes and security updates.

We do not guarantee specific support periods or security response times.

## Upgrading between versions

We understand that upgrading between major versions can require changes to your application.

To make upgrades easier, **Tempest provides [Rector](https://getrector.com/) suites** that automate many of the changes required when moving between major versions.

Our goal is to make upgrading as straightforward as possible, allowing developers to adopt new versions without having to manually address every breaking change.

While Rector can automate many changes, some upgrades may still require manual adjustments. We recommend reviewing the changes and running your application's test suite after upgrading.

## Which version should I use?

For new projects, we always recommend using the latest stable major version of Tempest alongside the latest stable version of PHP.

For existing projects, we recommend keeping both Tempest and PHP up to date to benefit from security fixes, performance improvements, and new language features.
Loading