Skip to content

feat(perforce,SCM): Remove beta flag, document on-demand source context fetching#17498

Open
mujacica wants to merge 1 commit intomasterfrom
feat/perforce-scm-ga
Open

feat(perforce,SCM): Remove beta flag, document on-demand source context fetching#17498
mujacica wants to merge 1 commit intomasterfrom
feat/perforce-scm-ga

Conversation

@mujacica
Copy link
Copy Markdown
Contributor

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 28, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Apr 28, 2026 9:44am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Apr 28, 2026 9:44am

Request Review

Copy link
Copy Markdown
Member

@bruno-garcia bruno-garcia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving to unblock but IMO we should reconsider where this setting lives before we move ahead

@@ -0,0 +1,59 @@
---
title: SCM Source Context
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about being more explicit about it:

Suggested change
title: SCM Source Context
title: SCM Source Context Fetching


Source context fetching is opt-in per project. To enable it:

1. In [sentry.io](https://sentry.io), go to **Settings > Projects > [your project] > General Settings**.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should have some settings redirect URL we can use here to have a link take users directly to that page

Source context fetching is opt-in per project. To enable it:

1. In [sentry.io](https://sentry.io), go to **Settings > Projects > [your project] > General Settings**.
2. Under **Client Security**, turn on **Enable SCM Source Context**.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I realize this was added here because we have the sourcemap fetching here. But I wonder if it should live under the SCM provider settings instead? "Client Security" Isn't where I'd think to find this.

In the case of sourcemaps it makes sense since anyone could send an event to Sentry that indicates where to fetch the sourcemaps from. But in the case of SCM source context, you read this from the Sentry integration settings, so a malicious actor can't influence where we fetch from.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

exactly my thoughts when I was looking to enable it 💯 Naturally I was going to Org Settings > Integrations > GitHub > Settings


## Features

- [SCM Source Context](/integrations/source-code-mgmt/source-context/) — render source lines around each stack-trace frame on demand from your SCM, for events that don't carry inline source context.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [SCM Source Context](/integrations/source-code-mgmt/source-context/) — render source lines around each stack-trace frame on demand from your SCM, for events that don't carry inline source context.
- [SCM Source Context](/integrations/source-code-mgmt/source-context/) — render source lines around each stack-trace frame on demand from your SCM provider, for events that don't carry inline source context.


The toggle requires `project:write` permission.

## How It Works
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would be great to have an image illustrating source context and highlighting the arrow on the right side . I've got this one, not sure if you wanna use it:

Image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants