SIGN IN SIGN UP

docs(guides): Improve intro paragraph formatting and expand custom spans description (#17169)

## DESCRIBE YOUR PR

Minor formatting and content improvements across the guides section:

- Split dense opening paragraphs in `issues-errors`, `logs`, `metrics`,
`querying-traces`, and `session-replay` guides into two sentences for
better readability
- Expanded the `custom-spans` guide intro to clarify what custom spans
add (business context, logical groupings, attributes) and note that they
often appear as parents of auto-generated child spans

## 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.): <!-- ENTER DATE HERE -->
- [ ] Other deadline: <!-- ENTER DATE HERE -->
- [x] 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](https://github.com/orgs/getsentry/teams/docs)
P
Paul Jaffre committed
e2ad258c74a1cf3cc044d6b48d8cdcb4a96ac95b
Parent: 8288792
Committed by GitHub <noreply@github.com> on 5/15/2026, 9:09:58 PM