Skip to content

Commit e7707fc

Browse files
committed
updated structure and put more content into expandables. Testing out some ideas.
1 parent eddbdb0 commit e7707fc

File tree

4 files changed

+37
-25
lines changed

4 files changed

+37
-25
lines changed

docs/platforms/javascript/common/index.mdx

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -37,16 +37,7 @@ Select which Sentry features you'd like to install in addition to Error Monitori
3737

3838
<PlatformSection supported={["javascript.nextjs"]}>
3939

40-
## Step 1: Choose Your Sentry Features (Optional)
41-
42-
During setup, you'll have the option to enable specific Sentry features for your application.
43-
Here's a quick overview of what's what:
44-
45-
- [**Error Monitoring**](/product/issues) (always enabled): Automatically report errors, uncaught exceptions, and unhandled rejections. If you have something that looks like an exception, Sentry can capture it.
46-
- [**Tracing**](/product/tracing): Track software performance while seeing the impact of errors across multiple systems. For example, distributed tracing allows you to follow a request from the frontend to the backend and back.
47-
- [**Session Replay**](/product/explore/session-replay/web/getting-started/): Get to the root cause of an issue faster by viewing a video-like reproduction of what was happening in the user's browser before, during, and after the problem.
48-
49-
## Step 2: Install
40+
## Step 1: Install
5041

5142
</PlatformSection>
5243

platform-includes/getting-started-install/javascript.nextjs.mdx

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,30 @@ To install Sentry using the installation wizard, run the following command withi
44
npx @sentry/wizard@latest -i nextjs
55
```
66

7-
The wizard starts guiding you through the setup process, which also includes enabling the Sentry features listed above.
7+
The wizard then guides you through the setup process, asking you to enable additional (optional) Sentry features for your application beyond error monitoring.
8+
9+
<Expandable title="Want to learn a bit more about these features?">
10+
11+
- [**Error Monitoring**](/product/issues) (always enabled): Automatically report errors,
12+
uncaught exceptions, and unhandled rejections. If you have something that
13+
looks like an exception, Sentry can capture it.
14+
- [**Tracing**](/product/tracing): Track software performance while seeing the
15+
impact of errors across multiple systems. For example, distributed tracing
16+
allows you to follow a request from the frontend to the backend and back.
17+
- [**Session Replay**](/product/explore/session-replay/web/getting-started/):
18+
Get to the root cause of an issue faster by viewing a video-like reproduction
19+
of what was happening in the user's browser before, during, and after the
20+
problem.
21+
22+
</Expandable>
823

924
<Alert level="warning" title="Important">
1025

11-
This guide assumes you enable all Sentry features during the wizard setup and allow it to create an example page and route. If you make different choices, you can still follow along, but you may need to make adjustments as you proceed.
26+
This guide assumes that you enable all features and allow the wizard to create an example page and route. Keep this in mind as you proceed.
1227

1328
</Alert>
1429

15-
You can always add or remove config options manually later if needed. Though, the earlier you set these up, the better.
30+
You can always add or remove features manually later if needed. Though, the earlier you set these up, the better.
1631

1732
<Expandable title="What does the installation wizard change inside your application?">
1833

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1 @@
1-
<Expandable title="Are you developing with Turbopack?">
21

3-
The Sentry SDK doesn't fully support `next dev --turbo` as Turbopack is still under development. This means that the Sentry SDK will not capture any data for the frontend. Other than that, your devserver should be fully operational.
4-
5-
Check the latest information on [Sentry's support for Turbopack on GitHub](https://github.com/getsentry/sentry-javascript/issues/8105).
6-
7-
</Expandable>
Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,42 @@
1-
## Step 3: Verify Your Setup
1+
## Step 2: Verify Your Setup
22

3-
Let's confirm that Sentry is working properly and sending data to your Sentry project by using the example page and route created by the installation wizard.
3+
<Expandable title="Are you developing with Turbopack?">
44

5-
1. Open the example page at [http://localhost:3000/sentry-example-page](http://localhost:3000/sentry-example-page)
5+
The Sentry SDK doesn't fully support `next dev --turbo` as Turbopack is still under development. This means that the Sentry SDK will not capture any data for the frontend. Other than that, your devserver should be fully operational.
6+
7+
Check the latest information on [Sentry's support for Turbopack on GitHub](https://github.com/getsentry/sentry-javascript/issues/8105).
8+
9+
</Expandable>
10+
11+
If you haven't tested your setup yet, let's do it now. You can confirm that Sentry is working properly and sending data to your Sentry project by using the example page and route created by the installation wizard.
12+
13+
1. Open the example page `/sentry-example-page`.
614
2. Click the "Throw error" button. This triggers two errors:
715
- a frontend error
816
- an error within the API route
917

10-
Sentry will capture both of these errors for you. Additionally, the button click starts a performance trace to measure the time it takes for the API request to complete.
18+
Sentry captures both of these errors for you. Additionally, the button click starts a performance trace to measure the time it takes for the API request to complete.
1119

1220
<Alert level="success" title="Tip">
1321

14-
Make sure to explore the example files' code in your project to understand what's happening after your button click.
22+
Don't forget to explore the example files' code in your project to understand what's happening after your button click.
1523

1624
</Alert>
1725

1826
### View Captured Data in Sentry
1927

20-
Now head over to your Sentry project on [Sentry.io](https://sentry.io) to view the collected data (it takes a couple of moments for the data to appear).
28+
Now, head over to your project on [Sentry.io](https://sentry.io) to view the collected data (it takes a couple of moments for the data to appear).
2129

2230
<Alert level="warning" title="Important">
2331

2432
Errors triggered from within your browser's developer tools (i.e., the browser console) are sandboxed, so they will not trigger Sentry's error monitoring.
2533

2634
</Alert>
2735

36+
<Expandable title="Need help locating the captured errors in your Sentry project?">
37+
2838
1. Open the [**Issues**](https://sentry.io/orgredirect/organizations/:orgslug/issues) page and select an error from the issues list to view the full details and context of this error. For an interactive UI walkthrough, click [here](/product/sentry-basics/integrate-frontend/generate-first-error/#ui-walkthrough).
2939
2. Open the [**Traces**](https://sentry.io/orgredirect/organizations/:orgslug/traces) page and select a trace to reveal more information about each span, its duration, and any errors. For an interactive UI walkthrough, click [here](/product/sentry-basics/distributed-tracing/generate-first-error/#ui-walkthrough).
3040
3. Open the [**Replays**](https://sentry.io/orgredirect/organizations/:orgslug/replays) page and select an entry from the list to get a detailed view where you can replay the interaction and get more information to help you troubleshoot.
41+
42+
</Expandable>

0 commit comments

Comments
 (0)