Skip to content

Conversation

@codyde
Copy link
Contributor

@codyde codyde commented Nov 10, 2025

  • Implementing new / beta tags for Logs + Metrics + OpenTelemetry
  • Adjusting ordering of content to reflect items that are higher priority for utilization / engagement
  • Utilize sidebar separator to breakup content
  • Implemement split layout for nextjs quickstart (text vs code)
CleanShot 2025-11-10 at 9  59 37@2x

@vercel
Copy link

vercel bot commented Nov 10, 2025

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

Project Deployment Preview Comments Updated (UTC)
develop-docs Ready Ready Preview Comment Nov 12, 2025 9:57am
sentry-docs Ready Ready Preview Comment Nov 12, 2025 9:57am

@codyde codyde force-pushed the feat/js-docs-apis-sampling-restructure branch from 86481fd to 26f7e78 Compare November 10, 2025 06:50
@codeowner-assignment codeowner-assignment bot requested a review from a team November 10, 2025 06:50
@codecov
Copy link

codecov bot commented Nov 10, 2025

Bundle Report

Changes will increase total bundle size by 11.94kB (0.05%) ⬆️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
sentry-docs-client-array-push 10.17MB 70 bytes (0.0%) ⬆️
sentry-docs-server-cjs 12.63MB 11.87kB (0.09%) ⬆️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name Size Change Total Size Change (%)
1729.js -3 bytes 1.74MB -0.0%
../instrumentation.js -3 bytes 1.07MB -0.0%
9523.js -3 bytes 1.04MB -0.0%
../app/[[...path]]/page.js.nft.json 3.58kB 771.51kB 0.47%
../app/platform-redirect/page.js.nft.json 3.58kB 771.43kB 0.47%
../app/sitemap.xml/route.js.nft.json 3.58kB 768.66kB 0.47%
4236.js 1.15kB 99.67kB 1.16%
view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
static/chunks/pages/_app-*.js -3 bytes 882.71kB -0.0%
static/css/*.css 291 bytes 16.8kB 1.76%
static/css/*.css -252 bytes 22.7kB -1.1%
static/css/*.css 37 bytes 748.33kB 0.0%
static/chunks/8321-*.js -3 bytes 425.87kB -0.0%
static/TOtJ2r_eaez6LSQBY7yBe/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/TOtJ2r_eaez6LSQBY7yBe/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
static/Su_Z3RWpucy3VcSxtHidd/_buildManifest.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/Su_Z3RWpucy3VcSxtHidd/_ssgManifest.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️

@codyde codyde removed the request for review from a team November 10, 2025 07:32
@codeowner-assignment codeowner-assignment bot requested a review from a team November 10, 2025 07:35
@codyde codyde removed the request for review from a team November 10, 2025 08:35
@codyde codyde force-pushed the feat/js-docs-apis-sampling-restructure branch from 32663b2 to 26f7e78 Compare November 11, 2025 01:05
@codeowner-assignment codeowner-assignment bot requested a review from a team November 11, 2025 01:06
- Move apis.mdx from /common/ to /common/configuration/
- Move sampling.mdx from /common/configuration/ to /common/
- Add redirects for both old paths to maintain existing links

This reorganization improves the documentation structure by:
- Placing APIs documentation with other configuration topics
- Elevating sampling to a top-level concept (not just a config option)

All existing URLs will automatically redirect to the new locations.
- Move Logs to sidebar_order: 2 (add 'new' badge)
- Move Metrics to sidebar_order: 3 (add 'beta' badge)
- Move Session Replay to sidebar_order: 4
- Move Tracing to sidebar_order: 5 (add section separator)

This reorders the navigation to prioritize newer features (Logs, Metrics)
higher in the sidebar for better discoverability.
- Rename 'Configuration' to 'Advanced Configuration' for clarity
- Add explicit sidebar_title
- Move to sidebar_order: 100 to position at end of navigation

This helps differentiate basic setup from advanced configuration topics.
@codyde codyde marked this pull request as ready for review November 11, 2025 06:01
@codyde codyde removed the request for review from a team November 11, 2025 06:01
@codyde codyde changed the title feat: Restructure JavaScript SDK documentation organization feat: JavaScript Docs display order, tags, split-layout Nov 11, 2025
description: "Learn more about APIs of the SDK."
customCanonicalTag: "/platforms/javascript/apis/"
sidebar_order: 3
sidebar_order: 1
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Missing Sidebar Section Causes Placement Issues

The apis.mdx file is missing the sidebar_section frontmatter field. All other pages in the diff have been assigned to either features or configuration sections, but this page will appear as unsectioned, potentially placing it in an unexpected sidebar position. Given its location under configuration/ and being at sidebar_order: 1, it likely should have sidebar_section: configuration.

Fix in Cursor Fix in Web

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