Skip to content

Commit 0297656

Browse files
authored
fix(releases): Document release:latest filter behaviour (#11423)
* Add explanation links * Document latest release logic * Clarify latest release search * Shorten link to same page
1 parent 5c25460 commit 0297656

File tree

6 files changed

+10
-6
lines changed

6 files changed

+10
-6
lines changed

docs/concepts/search/searchable-properties/events.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -505,7 +505,7 @@ Returns results with an approximate percentile of the field. Replace "XY" with 5
505505

506506
### `release`
507507

508-
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.
508+
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).
509509

510510
- **Type:** string
511511

docs/concepts/search/searchable-properties/issues.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -312,7 +312,7 @@ The id of the project.
312312

313313
### `release`
314314

315-
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.
315+
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).
316316

317317
- **Type:** string
318318

docs/concepts/search/searchable-properties/releases.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Below is a list of keys and tokens that can be used in the release search.
2222

2323
### `release`
2424

25-
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.
25+
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).
2626

2727
- **Type:** string
2828

docs/concepts/search/searchable-properties/session-replay.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ Similar to the `click.selector` search property, but only queries on [rage click
222222

223223
### `release`
224224

225-
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.
225+
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).
226226

227227
- **Type:** string
228228

docs/concepts/search/searchable-properties/spans.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ Name of the platform. This defaults to `other` and is only a property for platfo
135135

136136
### `release`
137137

138-
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`.
138+
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).
139139

140140
- **Type:** string
141141

docs/product/releases/usage/sorting-filtering.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ On the **Releases** page, you can use the "Sort By" dropdown to sort releases by
2020

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

23-
- `release` - Search based on string comparison.
23+
- `release` - Search based on string comparison, or `release:latest` to pick the most recent release. [Learn more](#latest-release).
2424
- `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).
2525

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

3232
Learn more about search queries in our [full Search documentation](/concepts/search/).
33+
34+
## Latest Release
35+
36+
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.

0 commit comments

Comments
 (0)