diff --git a/docs/product/releases/releases-throughout-sentry/img/charts_with_releases.png b/docs/product/releases/releases-throughout-sentry/img/charts_with_releases.png new file mode 100644 index 00000000000000..d0919abe4d346f Binary files /dev/null and b/docs/product/releases/releases-throughout-sentry/img/charts_with_releases.png differ diff --git a/docs/product/releases/releases-throughout-sentry/img/release_details_flyout_drawer.png b/docs/product/releases/releases-throughout-sentry/img/release_details_flyout_drawer.png new file mode 100644 index 00000000000000..68e91c73c8553c Binary files /dev/null and b/docs/product/releases/releases-throughout-sentry/img/release_details_flyout_drawer.png differ diff --git a/docs/product/releases/releases-throughout-sentry/img/release_details_tooltip.png b/docs/product/releases/releases-throughout-sentry/img/release_details_tooltip.png new file mode 100644 index 00000000000000..ca0920a43f9208 Binary files /dev/null and b/docs/product/releases/releases-throughout-sentry/img/release_details_tooltip.png differ diff --git a/docs/product/releases/releases-throughout-sentry/img/releases_list_flyout_drawer.png b/docs/product/releases/releases-throughout-sentry/img/releases_list_flyout_drawer.png new file mode 100644 index 00000000000000..9b27e5dcd454f4 Binary files /dev/null and b/docs/product/releases/releases-throughout-sentry/img/releases_list_flyout_drawer.png differ diff --git a/docs/product/releases/releases-throughout-sentry/index.mdx b/docs/product/releases/releases-throughout-sentry/index.mdx new file mode 100644 index 00000000000000..523ad4f964e4d3 --- /dev/null +++ b/docs/product/releases/releases-throughout-sentry/index.mdx @@ -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. + +
+![The Release details tooltip](./img/release_details_tooltip.png) +
+ +Clicking the link will open the [Release Details drawer](#release-details-drawer) with more details of the release, without leaving the current page.