Merge branch 'master' into session-replay-ga

Author: bruno-garcia

app/layout.tsx

@@ -57,8 +57,10 @@ export default function RootLayout({children}: {children: React.ReactNode}) {
         data-modal-override-open-class="kapa-ai-class" // all elements with this class will open the kapa ai modal
         data-project-name="Sentry"
         data-project-color="#6A5FC1"
-        data-project-logo="https://docs.sentry.io/_next/static/media/sentry-logo-dark.fc8e1eeb.svg"
+        data-project-logo="https://avatars.githubusercontent.com/u/1396951?s=280&v=4"
         data-font-family="var(--font-rubik)"
+        data-modal-disclaimer="Disclaimer: Welcome to our knowledge search bot! While we'd love to be able to answer all your questions, please remember this is a tool for searching our publicly available sources and not a support forum. Don't include any sensitive or personal information in your queries. For more on how Sentry handles your data, see our [Privacy Policy](https://sentry.io/privacy/). This form is protected by reCAPTCHA. Google's Privacy Policy and Google's Terms of Service apply."
+        data-modal-example-questions="How to set up Sentry for Next.js?,What are tracePropagationTargets?"
       />
     </html>
   );

develop-docs/integrations/azuredevops.mdx

@@ -0,0 +1,75 @@
+---
+title: Azure DevOps Integration
+sidebar_title: Azure DevOps
+---
+
+## Create an Azure Application
+
+Log into your Azure DevOps account or create a new one, and ensure you have a project set up.
+
+Make sure the organization has third-party access via OAuth enabled in the organization settings.
+![3p-oauth](./3p-oauth.png)
+
+
+To use the Azure DevOps integration you'll need to create an application.
+
+To start, you will need access to a [Microsoft Entra Admin Portal](https://entra.microsoft.com/#home)
+
+![Register App](./register-app.png)
+
+
+When configuring the app, use the following values:
+
+| Setting                         | Value                                                                                              |
+| ------------------------------- | -------------------------------------------------------------------------------------------------- |
+| Supported account types         | Accounts in any organizational directory |
+| Redirect URI                    | `{YOUR_DOMAIN}/extensions/vsts/setup`                                                              |
+
+<Note>
+
+Take note of your App ID as we'll need it later.
+![App ID](./app-id.png)
+
+</Note>
+
+Next go to Manager -> API Permissions to add the following permissions:
+* Azure DevOps (`vso.code`, `vso.graph`, `vso.work_item`, `vso.service_endpoint`)
+* Microsoft Graph (`User.Read`) (This should be added by default)
+
+![Permissions](./perms.png)
+
+Go to the "Certificates & secrets" tab and create a new client secret. Make sure you copy the secret as we'll need it later.
+
+![Client Secret](./client-secret.png)
+
+Add the App ID and Client Secret to `devlocal.py` like this:
+
+```python
+# Azure DevOps #
+SENTRY_OPTIONS["vsts_new.client-id"] = your-app-id
+SENTRY_OPTIONS["vsts_new.client-secret"] = your-client-secret
+```
+
+You can also add the App ID and Client Secret to `config.yml` like this:
+
+```yml
+# Azure DevOps #
+vsts_new.client-id: your-app-id
+vsts_new.client-secret: your-client-secret
+```
+
+You will also need to enable the feature flag to use the new Azure DevOps integration.
+Enable the `migrate-azure-devops-integration` feature flag in your organization.
+Add the following to your `devlocal.py` file:
+
+```python
+SENTRY_FEATURES["organizations:migrate-azure-devops-integration"] = True
+```
+
+<Alert title="Feature Flag" level="info">
+
+This is a temporary measure until we fully migrate to the new Azure DevOps integration and remove references to the old one.
+
+</Alert>
+
+Follow our [documentation on installing and configuring the Azure DevOps integration](https://docs.sentry.io/organization/integrations/source-code-mgmt/azure-devops/) to finish installation and use the integration.

develop-docs/integrations/azuredevops/3p-oauth.png

@@ -19,6 +19,7 @@ The difference only resides on a few things that are impossible to be hosted by
 - [Spend Allocation](https://docs.sentry.io/pricing/quotas/spend-allocation/), as it is tightly coupled with Billing Quotas.
 - AI & ML features (such as autofix), although the code is open at [getsentry/seer](https://github.com/getsentry/seer).
 - [Data Storage Location](https://docs.sentry.io/organization/data-storage-location/), because you own your data.
+- [iOS Symbolication](https://docs.sentry.io/platforms/apple/data-management/debug-files/symbol-servers#built-in-repositories), because Apple does not provide a public symbol server, nor do they allow us to distribute the Debug Information Files (DIFs) ourselves.
 
 To put things simply, consider self-hosted as the Business plan without any software limitations and no paid tier.
 

develop-docs/integrations/azuredevops/app-id.png

@@ -54,7 +54,7 @@ These are the hard stops that one needs to go through:
 - 24.8.0
 
 Versions to avoid upgrading to:
-- `23.7.0` (issues around database migrations and the Django 3 upgrade)
+- 23.7.0 (issues around database migrations and the Django 3 upgrade)
 
 As an example if one wants to go from `22.8.0` to `24.2.0` one needs the following upgrade path:
 
@@ -63,6 +63,13 @@ As an example if one wants to go from `22.8.0` to `24.2.0` one needs the followi
 (initial: 22.8.0) -> 23.6.2 -> 23.11.0 -> 24.2.0
 ```
 
+### Versions with known issues
+
+This section lists known issues with specific versions of the self-hosted Sentry. You may upgrade to these versions if you are not affected by any of these issues.
+
+- 24.12.0 has issues with login ([#3473](https://github.com/getsentry/self-hosted/issues/3473))
+- 24.12.1 has issues with login with orgs having hardware 2FA enabled ([#3473](https://github.com/getsentry/self-hosted/issues/3473))
+
 ## Nightly Builds
 
 We provide nightly builds from the [master branch of the self-hosted repository](https://github.com/getsentry/self-hosted/) for each new commit for [Sentry](https://github.com/getsentry/sentry), and all of the supporting projects: