From 10382002e34dfa80ca2ef2bf21426bc842fe6efe Mon Sep 17 00:00:00 2001 From: George Gritsouk <989898+gggritso@users.noreply.github.com> Date: Tue, 24 Sep 2024 11:00:13 -0400 Subject: [PATCH 1/4] Add explanation links --- docs/concepts/search/searchable-properties/events.mdx | 2 +- docs/concepts/search/searchable-properties/issues.mdx | 2 +- docs/concepts/search/searchable-properties/releases.mdx | 2 +- docs/concepts/search/searchable-properties/session-replay.mdx | 2 +- docs/concepts/search/searchable-properties/spans.mdx | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/concepts/search/searchable-properties/events.mdx b/docs/concepts/search/searchable-properties/events.mdx index 3ff9a57fb0369..adf048f77a385 100644 --- a/docs/concepts/search/searchable-properties/events.mdx +++ b/docs/concepts/search/searchable-properties/events.mdx @@ -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 diff --git a/docs/concepts/search/searchable-properties/issues.mdx b/docs/concepts/search/searchable-properties/issues.mdx index 008e87be88f12..cbd54e5a25668 100644 --- a/docs/concepts/search/searchable-properties/issues.mdx +++ b/docs/concepts/search/searchable-properties/issues.mdx @@ -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 diff --git a/docs/concepts/search/searchable-properties/releases.mdx b/docs/concepts/search/searchable-properties/releases.mdx index a92fba6cb2393..c92eafe5e68d5 100644 --- a/docs/concepts/search/searchable-properties/releases.mdx +++ b/docs/concepts/search/searchable-properties/releases.mdx @@ -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 diff --git a/docs/concepts/search/searchable-properties/session-replay.mdx b/docs/concepts/search/searchable-properties/session-replay.mdx index c9191b37bc4f1..83a01000f60a0 100644 --- a/docs/concepts/search/searchable-properties/session-replay.mdx +++ b/docs/concepts/search/searchable-properties/session-replay.mdx @@ -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 diff --git a/docs/concepts/search/searchable-properties/spans.mdx b/docs/concepts/search/searchable-properties/spans.mdx index 7794cdf199733..070b50c2561ea 100644 --- a/docs/concepts/search/searchable-properties/spans.mdx +++ b/docs/concepts/search/searchable-properties/spans.mdx @@ -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 From 0262041d4de36e5dcb70114d4374781f75df48f8 Mon Sep 17 00:00:00 2001 From: George Gritsouk <989898+gggritso@users.noreply.github.com> Date: Tue, 24 Sep 2024 13:48:23 -0400 Subject: [PATCH 2/4] Document latest release logic --- docs/product/releases/usage/sorting-filtering.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/product/releases/usage/sorting-filtering.mdx b/docs/product/releases/usage/sorting-filtering.mdx index a3df5f1689f71..d72d48380f188 100644 --- a/docs/product/releases/usage/sorting-filtering.mdx +++ b/docs/product/releases/usage/sorting-filtering.mdx @@ -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. From f50f76dcead5d04b1e7518cd75aef1cf79e66d73 Mon Sep 17 00:00:00 2001 From: George Gritsouk <989898+gggritso@users.noreply.github.com> Date: Tue, 24 Sep 2024 13:49:52 -0400 Subject: [PATCH 3/4] Clarify latest release search --- docs/product/releases/usage/sorting-filtering.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/product/releases/usage/sorting-filtering.mdx b/docs/product/releases/usage/sorting-filtering.mdx index d72d48380f188..1421aaeb1afb6 100644 --- a/docs/product/releases/usage/sorting-filtering.mdx +++ b/docs/product/releases/usage/sorting-filtering.mdx @@ -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](/product/releases/usage/sorting-filtering/#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: From 7185867d70578ca896190ed0617b82aa79318e17 Mon Sep 17 00:00:00 2001 From: George Gritsouk <989898+gggritso@users.noreply.github.com> Date: Tue, 24 Sep 2024 13:51:51 -0400 Subject: [PATCH 4/4] Shorten link to same page --- docs/product/releases/usage/sorting-filtering.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/product/releases/usage/sorting-filtering.mdx b/docs/product/releases/usage/sorting-filtering.mdx index 1421aaeb1afb6..7144bb8e8efe6 100644 --- a/docs/product/releases/usage/sorting-filtering.mdx +++ b/docs/product/releases/usage/sorting-filtering.mdx @@ -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, or `release:latest` to pick the most recent release. [Learn more](/product/releases/usage/sorting-filtering/#latest-release). +- `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: