diff --git a/packages/angular/README.md b/packages/angular/README.md
index 8251d0b226f7..77ac7ab11ebf 100644
--- a/packages/angular/README.md
+++ b/packages/angular/README.md
@@ -10,219 +10,15 @@
[](https://www.npmjs.com/package/@sentry/angular)
[](https://www.npmjs.com/package/@sentry/angular)
-## Links
+The official Sentry SDK for monitoring Angular applications.
-- [Official SDK Docs](https://docs.sentry.io/platforms/javascript/angular/)
+## Documentation
-## Angular Version Compatibility
+- [Getting started](https://docs.sentry.io/platforms/javascript/guides/angular/)
+- [Configuration](https://docs.sentry.io/platforms/javascript/guides/angular/configuration/)
+- [Angular-specific features](https://docs.sentry.io/platforms/javascript/guides/angular/features/)
-This SDK officially supports Angular 14 to 20.
+## Support
-If you're using an older Angular version please check the
-[compatibility table in the docs](https://docs.sentry.io/platforms/javascript/guides/angular/#angular-version-compatibility).
-
-If you're using an older version of Angular and experience problems with the Angular SDK, we recommend downgrading the
-SDK to version 7.x. Please note that we don't provide any support for Angular versions below 10.
-
-## General
-
-This package is a wrapper around `@sentry/browser`, with added functionality related to Angular. All methods available
-in `@sentry/browser` can be imported from `@sentry/angular`.
-
-To use this SDK, call `Sentry.init(options)` before you bootstrap your Angular application.
-
-```javascript
-import { bootstrapApplication } from '@angular/platform-browser';
-import { init } from '@sentry/angular';
-
-import { AppComponent } from './app/app.component';
-
-init({
- dsn: '__DSN__',
- // ...
-});
-
-bootstrapApplication(AppComponent, appConfig);
-```
-
-### ErrorHandler
-
-`@sentry/angular` exports a function to instantiate an ErrorHandler provider that will automatically send Javascript
-errors captured by the Angular's error handler.
-
-```ts
-import { ApplicationConfig, NgModule, ErrorHandler } from '@angular/core';
-import { createErrorHandler } from '@sentry/angular';
-
-export const appConfig: ApplicationConfig = {
- providers: [
- {
- provide: ErrorHandler,
- useValue: createErrorHandler({
- showDialog: true,
- }),
- },
- ],
-};
-
-// Or using an old module approach:
-@NgModule({
- // ...
- providers: [
- {
- provide: ErrorHandler,
- useValue: createErrorHandler({
- showDialog: true,
- }),
- },
- ],
- // ...
-})
-export class AppModule {}
-```
-
-Additionally, `createErrorHandler` accepts a set of options that allows you to configure its behavior. For more details
-see `ErrorHandlerOptions` interface in `src/errorhandler.ts`.
-
-### Tracing
-
-`@sentry/angular` exports a Trace Service, Directive and Decorators that leverage the tracing features to add
-Angular-related spans to transactions. If tracing is not enabled, this functionality will not work. The SDK's
-`TraceService` itself tracks route changes and durations, while directive and decorators are tracking components
-initializations.
-
-#### Install
-
-Registering a Trace Service is a 3-step process.
-
-1. Register and configure the `BrowserTracing` integration, including custom Angular routing instrumentation:
-
-```javascript
-import { init, browserTracingIntegration } from '@sentry/angular';
-
-init({
- dsn: '__DSN__',
- integrations: [browserTracingIntegration()],
- tracePropagationTargets: ['localhost', 'https://yourserver.io/api'],
- tracesSampleRate: 1,
-});
-```
-
-2. Inject the `TraceService` in the `APP_INITIALIZER`:
-
-```ts
-import { ApplicationConfig, APP_INITIALIZER, provideAppInitializer } from '@angular/core';
-
-export const appConfig: ApplicationConfig = {
- providers: [
- {
- provide: APP_INITIALIZER,
- useFactory: () => () => {},
- deps: [TraceService],
- multi: true,
- },
-
- // Starting with Angular 19, we can use `provideAppInitializer`
- // instead of directly providing `APP_INITIALIZER` (deprecated):
- provideAppInitializer(() => inject(TraceService)),
- ],
-};
-
-// Or using an old module approach:
-@NgModule({
- // ...
- providers: [
- {
- provide: APP_INITIALIZER,
- useFactory: () => () => {},
- deps: [TraceService],
- multi: true,
- },
-
- // Starting with Angular 19, we can use `provideAppInitializer`
- // instead of directly providing `APP_INITIALIZER` (deprecated):
- provideAppInitializer(() => inject(TraceService)),
- ],
- // ...
-})
-export class AppModule {}
-```
-
-#### Use
-
-To track Angular components as part of your transactions, you have 3 options.
-
-_TraceDirective:_ used to track a duration between `OnInit` and `AfterViewInit` lifecycle hooks in template:
-
-```ts
-import { TraceModule } from '@sentry/angular';
-
-@Component({
- selector: 'some-component',
- imports: [TraceModule],
- // ...
-})
-export class SomeComponentThatUsesTraceDirective {}
-```
-
-Then, inside your component's template (keep in mind that the directive's name attribute is required):
-
-```html
-
-
-
-```
-
-_TraceClass:_ used to track a duration between `OnInit` and `AfterViewInit` lifecycle hooks in components:
-
-```javascript
-import { Component } from '@angular/core';
-import { TraceClass } from '@sentry/angular';
-
-@Component({
- selector: 'layout-header',
- templateUrl: './header.component.html',
-})
-@TraceClass()
-export class HeaderComponent {
- // ...
-}
-```
-
-_TraceMethod:_ used to track a specific lifecycle hooks as point-in-time spans in components:
-
-```javascript
-import { Component, OnInit } from '@angular/core';
-import { TraceMethod } from '@sentry/angular';
-
-@Component({
- selector: 'app-footer',
- templateUrl: './footer.component.html',
-})
-export class FooterComponent implements OnInit {
- @TraceMethod()
- ngOnInit() {}
-}
-```
-
-You can also add your own custom spans via `startSpan()`. For example, if you'd like to track the duration of Angular
-boostraping process, you can do it as follows:
-
-```javascript
-import { enableProdMode } from '@angular/core';
-import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
-import { init, startSpan } from '@sentry/angular';
-
-import { AppModule } from './app/app.module';
-
-// ...
-startSpan(
- {
- name: 'platform-browser-dynamic',
- op: 'ui.mount',
- },
- async () => {
- await platformBrowserDynamic().bootstrapModule(AppModule);
- },
-);
-```
+- [Report a bug](https://github.com/getsentry/sentry-javascript/issues/new/choose)
+- [Contributing](https://github.com/getsentry/sentry-javascript/blob/develop/CONTRIBUTING.md)