Skip to content

fix(releases): Document release:latest filter behaviour #11423

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Sep 26, 2024
Merged
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: 1 addition & 1 deletion docs/concepts/search/searchable-properties/events.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -505,7 +505,7 @@ Returns results with an approximate percentile of the field. Replace "XY" with 5

### `release`

A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release.
A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release. [Learn more](/product/releases/usage/sorting-filtering/#latest-release).

- **Type:** string

Expand Down
2 changes: 1 addition & 1 deletion docs/concepts/search/searchable-properties/issues.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -312,7 +312,7 @@ The id of the project.

### `release`

A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release.
A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release. [Learn more](/product/releases/usage/sorting-filtering/#latest-release).

- **Type:** string

Expand Down
2 changes: 1 addition & 1 deletion docs/concepts/search/searchable-properties/releases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Below is a list of keys and tokens that can be used in the release search.

### `release`

A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release.
A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release. [Learn more](/product/releases/usage/sorting-filtering/#latest-release).

- **Type:** string

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -222,7 +222,7 @@ Similar to the `click.selector` search property, but only queries on [rage click

### `release`

A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release.
A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release. [Learn more](/product/releases/usage/sorting-filtering/#latest-release).

- **Type:** string

Expand Down
2 changes: 1 addition & 1 deletion docs/concepts/search/searchable-properties/spans.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ Name of the platform. This defaults to `other` and is only a property for platfo

### `release`

A release is a version of your code deployed to an environment. You can create a token that matches a release exactly, or pick the most recent release by using `release:latest`.
A release is a version of your code deployed to an environment. You can create a token that matches a release exactly, or pick the most recent release by using `release:latest`. [Learn more](/product/releases/usage/sorting-filtering/#latest-release).

- **Type:** string

Expand Down
6 changes: 5 additions & 1 deletion docs/product/releases/usage/sorting-filtering.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ On the **Releases** page, you can use the "Sort By" dropdown to sort releases by

Search on the **Releases** page supports both raw text and query syntax, and you can search using the following properties:

- `release` - Search based on string comparison.
- `release` - Search based on string comparison, or `release:latest` to pick the most recent release. [Learn more](#latest-release).
- `release.stage` - Search releases with matching adoption stage. Can be `adopted`, `low_adoption`, or `replaced`. Learn more about [release adoption stages](/product/releases/health/#adoption-stages).

If you are using our [semantic versioning](/platform-redirect/?next=/configuration/releases/%23bind-the-version) format, you can use the following query tokens:
Expand All @@ -30,3 +30,7 @@ If you are using our [semantic versioning](/platform-redirect/?next=/configurati
- `release.build` - Search releases with matching build numbers.

Learn more about search queries in our [full Search documentation](/concepts/search/).

## Latest Release

The special `release:latest` filter intelligently finds the most recent release for every selected project. For projects that use [Semantic Version](/platform-redirect/?next=/configuration/releases/%23bind-the-version) numbers, the latest release is one with the highest version number. For projects that use Commit SHA for versioning, the latest release is the most recent one.
Loading