Skip to content

Commit

Permalink
Update versioning policy for editor integration (#12375)
Browse files Browse the repository at this point in the history
## Summary

Following the stabilization of the Ruff language server, we need to
update our versioning policy to account for any changes in it. This
could be server settings, capability, etc.

This PR also adds a new section for the VS Code extension which is
adopted from [Biome's versioning
policy](https://biomejs.dev/internals/versioning/#visual-studio-code-extension)
for the same.

---------

Co-authored-by: Zanie Blue <contact@zanie.dev>
  • Loading branch information
dhruvmanila and zanieb committed Jul 18, 2024
1 parent 764d9ab commit 7953f6a
Showing 1 changed file with 18 additions and 1 deletion.
19 changes: 18 additions & 1 deletion docs/versioning.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,11 @@ Ruff uses a custom versioning scheme that uses the **minor** version number for
- Stable rules are added to the default set
- Stable rules are removed from the default set
- A safe fix for a rule is promoted to stable
- Formatter:
- Formatter:
- The stable style changed
- Language server:
- An existing capability is removed
- A deprecated server setting is removed

**Patch** version increases will occur when:

Expand All @@ -40,6 +43,10 @@ Ruff uses a custom versioning scheme that uses the **minor** version number for
- Formatter:
- The stable style changed to prevent invalid syntax, changes to the program's semantics, or removal of comments
- The preview style changed
- Language server:
- Support for a new capability is added
- A new server setting is added
- A server setting is deprecated


## Preview mode
Expand Down Expand Up @@ -70,3 +77,13 @@ Fixes have three applicability levels:
- **Safe**: Can be applied automatically.

Fixes for rules may be introduced at a lower applicability, then promoted to a higher applicability. Reducing the applicability of a fix is not a breaking change. The applicability of a given fix may change when the preview mode is enabled.

## Visual Studio Code Extension

Visual Studio Code [doesn't support pre-release
tags](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#prerelease-extensions)
for extensions. Consequently, Ruff uses the following scheme to distinguish between stable and
preview releases:

Stable releases use even numbers in minor version component: `2024.30.0`, `2024.32.0`, `2024.34.0`, …
Preview releases use odd numbers in minor version component: `2024.31.0`, `2024.33.0`, `2024.35.0`, …

0 comments on commit 7953f6a

Please sign in to comment.