Skip to content

feat(releases): Add some notes about the new Releases flyout #13730

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 5 commits into from
May 21, 2025
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
33 changes: 33 additions & 0 deletions docs/product/releases/releases-throughout-sentry/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: Using Releases Across Sentry
sidebar_order: 60
description: "Learn how to use releases throughout Sentry's product."
---

## Charts

In most charts, releases are grouped up and displayed as colored boxes underneath the chart. Hovering over the boxes shows a tooltip with the number of releases in that group. Clicking on a box opens a flyout drawer to let you explore the releases within that group.

![A chart showing with the releases boxes underneath the chart](./img/charts_with_releases.png)

## Releases List Drawer

Clicking on a release box underneath a chart opens a flyout drawer showing a zoomed-in view of the chart that was clicked on. This zoomed-in chart has the same time interval as the clicked releases box. There is also a table with a list of the releases inside that time interval. Selecting a single release from the chart or the table will open its details inside of the drawer.

![The Releases List flyout drawer with chart and table](./img/releases_list_flyout_drawer.png)

## Release Details Drawer

The Release Details drawer gives a quick view of a release without leaving the current page. It shows new issues, commits, and files in the release. If you want to explore the Release further, you can click the "View Full Details" button in the top right corner of the flyout.

![The Release Details flyout drawer showing new issues in releases](./img/release_details_flyout_drawer.png)

## Release Version Link

Outside of the **Releases List** page, hovering over any release version link will open a tooltip, showing a tiny preview of the release.

<div style={{width: "309px", height: "220px"}}>
![The Release details tooltip](./img/release_details_tooltip.png)
</div>

Clicking the link will open the [Release Details drawer](#release-details-drawer) with more details of the release, without leaving the current page.