Skip to content

Conversation

@sfanahata
Copy link
Contributor

@sfanahata sfanahata commented Jan 28, 2026

Summary

Improves cross-feature discoverability and modernizes the Logs documentation across all JavaScript SDK guides.

Main preview: https://sentry-docs-git-docs-feature-related-sections.sentry.dev/platforms/javascript/guides/react/logs/

Changes

Related Features Sections

Added "Related Features" sections to four key feature pages, helping users discover how Sentry features work together:

  • Logs → links to Tracing, Session Replay, Error Monitoring
  • Tracing → links to Session Replay, Logs
  • Session Replay → links to Tracing, Logs
  • Metrics → links to Tracing, Logs, Error Monitoring

Uses PlatformSection to conditionally show relevant links (e.g., Session Replay links hidden on server-side platforms).

Logs Page Modernization

Rewrote /common/logs/index.mdx with a two-column SplitLayout for better readability:

  • Setup — Enable logging configuration
  • Send Logs — Log levels table with usage guidance
  • Add Context — Attributes and fmt helper
  • Scope Attributes — Global, isolation, and current scopes (with SDK version note)
  • Console Integration — Migration path from console.log (with Consola mention)
  • Filter LogsbeforeSendLog hook examples

Other Improvements

  • Renamed "Next Steps" to feature-specific names ("Tracing Next Steps", "Replay Next Steps")
  • Fixed bullet spacing issues by using inline PlatformSection components

Preview URLs

  • /platforms/javascript/guides/react/logs/
  • /platforms/javascript/guides/react/tracing/
  • /platforms/javascript/guides/react/session-replay/
  • /platforms/javascript/guides/react/metrics/

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

- Add Related Features sections to Logs, Tracing, Session Replay, and Metrics pages
- Rewrite Logs page with two-column SplitLayout for better readability
- Add log levels table, scope attributes, console integration, and filtering sections
- Include SDK version requirements where relevant
- Rename Next Steps to feature-specific names (Tracing Next Steps, Replay Next Steps)
- Fix bullet spacing issues with inline PlatformSection components

Uses PlatformSection to hide irrelevant links (e.g., Session Replay on server-side platforms).
@vercel
Copy link

vercel bot commented Jan 28, 2026

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

Project Deployment Review Updated (UTC)
sentry-docs Ready Ready Preview, Comment Jan 28, 2026 11:25pm
1 Skipped Deployment
Project Deployment Review Updated (UTC)
develop-docs Ignored Ignored Preview Jan 28, 2026 11:25pm

Request Review

- Update intro with 'what broke vs why' framing from blog post
- Add high-cardinality explanation as key differentiator
- Add 'How Logs Link to Other Features' section with navigation workflow
- Add Best Practices section (wide events, business context)
- Link Traces, Session Replay, and Errors to product docs
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.

2 participants