diff --git a/.github/workflows/update-docs-changelog.yml b/.github/workflows/update-docs-changelog.yml index 53fdd4659d5ed..af963c9208cc9 100644 --- a/.github/workflows/update-docs-changelog.yml +++ b/.github/workflows/update-docs-changelog.yml @@ -61,11 +61,18 @@ jobs: # Check if PR already exists existing_pr=$(gh pr list --head "$branch" --json number --jq '.[0].number') - if [ -n "$existing_pr" ]; then - echo "PR #$existing_pr already exists, updated branch" - else + if [ -z "$existing_pr" ]; then gh pr create \ --title "chore: Update docs changelog" \ --body "Automated update of the docs changelog from recent merged PRs." - gh pr merge "$branch" --squash --auto + else + echo "PR #$existing_pr already exists, updated branch" fi + + # Merge with --admin to bypass the review requirement and required + # checks (e.g. lint-404, which flags not-yet-deployed doc links in the + # generated changelog). This file is fully bot-generated, so admin + # merge is safe and matches the pattern used by bump-api-schema-sha.yml. + # Using --auto here instead caused PRs to pile up unmerged, since the + # bot PR never receives the required approving review. + gh pr merge "$branch" --squash --admin --delete-branch diff --git a/includes/docs-changelog.mdx b/includes/docs-changelog.mdx index c2c580b837357..b8d83c957349a 100644 --- a/includes/docs-changelog.mdx +++ b/includes/docs-changelog.mdx @@ -1,256 +1,199 @@ -## August 11, 2026 +## September 18, 2026 -### [feat(agents): Agents and conversations updates for product changes](https://github.com/getsentry/sentry-docs/pull/19006) +### [docs(integrations): Add Superplane third-party integration](https://github.com/getsentry/sentry-docs/pull/19519) **Modified:** -- [AI Agents Module](https://develop.sentry.dev/sdk/telemetry/traces/modules/ai-agents/) -- [Sentry for AI](/ai/) -- [Tracing](/concepts/key-terms/tracing/) -- [Set Up Tracing](/platforms/dotnet/tracing/) -- [Instrument Agents](/platforms/dotnet/tracing/instrumentation/ai-agents-module/) -- [Browser AI Tracing](/platforms/javascript/agent-tracing/) -- [Set Up Agent Tracing](/platforms/javascript/guides/node/agent-tracing/) -- [Manual Instrumentation](/platforms/javascript/guides/node/agent-tracing/manual-instrumentation/) -- [LangChain](/platforms/javascript/guides/node/configuration/integrations/langchain/) -- [LangGraph](/platforms/javascript/guides/node/configuration/integrations/langgraph/) -- [Set Up Tracing](/platforms/javascript/tracing/) -- [Instrument MCP Servers](/platforms/javascript/guides/node/tracing/instrumentation/mcp-module/) -- [Example Instrumentation](/platforms/javascript/tracing/span-metrics/examples/) -- [Cloudflare Agents SDK](/platforms/javascript/guides/cloudflare/agent-tracing/agents-sdk/) -- [Next.js](/platforms/javascript/guides/nextjs/) -- [Manual Setup](/platforms/javascript/guides/nextjs/manual-setup/) -- [Pages Router Setup](/platforms/javascript/guides/nextjs/manual-setup/pages-router/) -- [Webpack Setup](/platforms/javascript/guides/nextjs/manual-setup/webpack-setup/) -- [Set Up Tracing in PHP](/platforms/php/tracing/) -- [Set Up Agent Tracing](/platforms/php/guides/laravel/agent-tracing/) -- [Data Collected](/platforms/php/guides/laravel/data-management/data-collected/) -- [Set Up Agent Tracing](/platforms/python/agent-tracing/) -- [Manual Instrumentation](/platforms/python/agent-tracing/manual-instrumentation/) -- [Anthropic](/platforms/python/integrations/anthropic/) -- [Google Gen AI](/platforms/python/integrations/google-genai/) -- [Hugging Face Hub](/platforms/python/integrations/huggingface_hub/) -- [LangChain](/platforms/python/integrations/langchain/) -- [LangGraph](/platforms/python/integrations/langgraph/) -- [LiteLLM](/platforms/python/integrations/litellm/) -- [OpenAI Agents](/platforms/python/integrations/openai-agents/) -- [OpenAI](/platforms/python/integrations/openai/) -- [Pydantic AI](/platforms/python/integrations/pydantic-ai/) -- [Set Up Tracing](/platforms/python/tracing/) -- [Custom Instrumentation](/platforms/python/tracing/instrumentation/custom-instrumentation/) -- [Instrument MCP Servers](/platforms/python/tracing/instrumentation/custom-instrumentation/mcp-module/) -- [Agent Tracing](/platforms/react-native/agent-tracing/) -- [LangGraph](/platforms/react-native/integrations/langgraph/) -- [Set Up Tracing](/platforms/ruby/tracing/) -- [Instrument Agents](/platforms/ruby/tracing/instrumentation/custom-instrumentation/ai-agents-module/) -- [Conversations](/product/agents/conversations/) -- [Model Costs](/product/agents/costs/) -- [Agents Dashboards](/product/agents/dashboards/) -- [Set Up](/product/agents/getting-started/) -- [Agents](/product/agents/) -- [Naming Your Agents](/product/agents/naming/) -- [Data Privacy](/product/agents/privacy/) -- [Sampling Strategies](/product/agents/sampling/) -- [Agents Dashboards](/product/dashboards/sentry-dashboards/ai/agents/) -- [AI](/product/dashboards/sentry-dashboards/ai/) -- [MCP Dashboards](/product/dashboards/sentry-dashboards/ai/mcp/) -- [Product Walkthroughs](/product/) -- [Logs](/product/logs/) -- [MCP Dashboards](/product/mcp-servers/dashboard/) -- [Set Up](/product/mcp-servers/getting-started/) -- [MCP Servers](/product/mcp-servers/) -- [Application Metrics](/product/metrics/) -- [Getting Started With Sentry](/product/sentry-basics/) -- [Performance Monitoring](/product/sentry-basics/performance-monitoring/) -- [Agentic Workflow](/product/snapshots/agentic-workflow/) +- [Third-Party Integrations](/integrations/third-party-integrations/) --- -### [docs(integrations): Clarify Cursor integration redirect](https://github.com/getsentry/sentry-docs/pull/18935) +### [docs(eve): Prevent duplicate instrumentation with SDK v11](https://github.com/getsentry/sentry-docs/pull/19461) **Modified:** -- [Third-Party Integrations](/integrations/third-party-integrations/) +- [Eve](/platforms/javascript/guides/eve/) --- -### [fix(scrubbing): Clarify safe-field path selector logic](https://github.com/getsentry/sentry-docs/pull/19010) +### [docs(releases): Remove early access alert from auto release creation](https://github.com/getsentry/sentry-docs/pull/19491) **Modified:** -- [Server-Side Data Scrubbing](/security-legal-pii/scrubbing/server-side-scrubbing/) +- [Disable Release Creation](/product/releases/usage/disable-auto-release-creation/) --- -### [docs(native): update note on `decref` for event hooks](https://github.com/getsentry/sentry-docs/pull/18996) +### [docs(agent-tracing): Limit guides to server runtimes](https://github.com/getsentry/sentry-docs/pull/19452) **Modified:** -- [Options](/platforms/native/configuration/options/) +- [Anthropic](/platforms/javascript/guides/node/agent-tracing/anthropic/) +- [Google Gen AI](/platforms/javascript/guides/node/agent-tracing/google-genai/) +- [Set Up Agent Tracing](/platforms/javascript/agent-tracing/) +- [LangChain](/platforms/javascript/guides/node/agent-tracing/langchain/) +- [LangGraph](/platforms/javascript/guides/node/agent-tracing/langgraph/) +- [Manual Instrumentation](/platforms/javascript/guides/node/agent-tracing/manual-instrumentation/) +- [OpenAI](/platforms/javascript/guides/node/agent-tracing/openai/) +- [Vercel AI](/platforms/javascript/guides/node/agent-tracing/vercelai/) +- [APIs](/platforms/javascript/configuration/apis/) +- [Set Up Tracing](/platforms/javascript/tracing/) +- [Set Up Tracing](/platforms/react-native/tracing/) +- [Set Up](/product/agents/getting-started/) + +**Removed:** +- [Agent Tracing](/platforms/react-native/agent-tracing/) --- -## August 10, 2026 +## September 17, 2026 -### [fix(dev): Update installation command for @sentry/conventions](https://github.com/getsentry/sentry-docs/pull/19005) +### [docs(integrations): Add Arg0 third-party integration](https://github.com/getsentry/sentry-docs/pull/19483) **Modified:** -- [Sentry Conventions](https://develop.sentry.dev/engineering-practices/sentry-conventions/) +- [Third-Party Integrations](/integrations/third-party-integrations/) --- -### [docs(snapshots): Add GitHub Enterprise setup](https://github.com/getsentry/sentry-docs/pull/19003) +### [docs(snapshots): Document snapshot auto-approval](https://github.com/getsentry/sentry-docs/pull/19480) **Modified:** -- [Integrating Into CI](/product/snapshots/integrating-into-ci/) +- [Reviewing Snapshots](/product/snapshots/reviewing-snapshots/) --- -### [docs(native): Document metrics options](https://github.com/getsentry/sentry-docs/pull/18975) +### [feat(agent tracing): Created agent tracing context page](https://github.com/getsentry/sentry-docs/pull/19437) + +**Added:** +- [Agent Tracing - What It Is and How To Use It](/concepts/key-terms/agent-tracing/) **Modified:** -- [Options](/platforms/native/configuration/options/) +- [Agents](/product/agents/) --- -### [docs(native): Document user feedback scope data and before_send_feedback](https://github.com/getsentry/sentry-docs/pull/18982) +### [docs(agent-tracing): Normalize GenAI attribute docs](https://github.com/getsentry/sentry-docs/pull/19459) **Modified:** -- [Filtering](/platforms/native/configuration/filtering/) -- [Options](/platforms/native/configuration/options/) -- [Set Up User Feedback](/platforms/native/user-feedback/) +- [Manual Instrumentation](/platforms/javascript/guides/node/agent-tracing/manual-instrumentation/) +- [Mastra](/platforms/javascript/guides/node/agent-tracing/mastra/) +- [Manual Instrumentation](/platforms/python/agent-tracing/manual-instrumentation/) +- [Conversations](/product/agents/conversations/) --- -### [docs(native): Document scope attributes and scoped logs and metrics](https://github.com/getsentry/sentry-docs/pull/18981) +### [docs(react-native): Document Session Replay runtime controls](https://github.com/getsentry/sentry-docs/pull/19393) **Modified:** -- [Attributes](/platforms/native/enriching-events/attributes/) -- [Scopes](/platforms/native/enriching-events/scopes/) +- [Set Up Session Replay](/platforms/react-native/session-replay/) --- -### [docs(unity): updated il2cpp and known limitations](https://github.com/getsentry/sentry-docs/pull/18976) +### [fix agent tracing manual link spacing](https://github.com/getsentry/sentry-docs/pull/19457) **Modified:** -- [IL2CPP Line Numbers](/platforms/unity/configuration/il2cpp/) -- [Known Limitations](/platforms/unity/troubleshooting/known-limitations/) -- [Automatic Error Capture](/platforms/unity/usage/automatic-error-capture/) -- [Usage](/platforms/unity/usage/) +- [Set Up Agent Tracing](/platforms/javascript/agent-tracing/) --- -## August 7, 2026 - -### [docs(analytics): Use functional React examples](https://github.com/getsentry/sentry-docs/pull/18966) +### [ref: remove `enable_logs` and `enable_metrics`](https://github.com/getsentry/sentry-docs/pull/19148) **Modified:** -- [Analytics](https://develop.sentry.dev/development-infrastructure/analytics/) +- [What to Log in Sentry](/get-started/guides/logs/) +- [Options](/platforms/php/configuration/options/) +- [Monolog](/platforms/php/integrations/monolog/) +- [Set Up Logs](/platforms/php/logs/) +- [Set Up Metrics](/platforms/php/metrics/) +- [Laravel Options](/platforms/php/guides/laravel/configuration/laravel-options/) +- [Set Up Logs](/platforms/php/guides/laravel/logs/) +- [Symfony Options](/platforms/php/guides/symfony/configuration/symfony-options/) +- [Monolog](/platforms/php/guides/symfony/integrations/monolog/) +- [Set Up Logs](/platforms/php/guides/symfony/logs/) +- [PHP](/platforms/php/) --- -### [docs(native): Rewrite Scopes page to match the SDK's scope model](https://github.com/getsentry/sentry-docs/pull/18947) +### [docs(eve): remove unsupported guide pages](https://github.com/getsentry/sentry-docs/pull/19450) **Modified:** -- [Scopes](/platforms/native/enriching-events/scopes/) +- [Set Up Feature Flags](/platforms/javascript/feature-flags/) +- [CommonJS (CJS)](/platforms/javascript/guides/node/install/commonjs/) +- [ESM without CLI Flag](/platforms/javascript/guides/node/install/esm-without-import/) +- [ESM (MJS)](/platforms/javascript/guides/node/install/esm/) +- [Installation Methods](/platforms/javascript/install/) +- [Late Initialization (ESM or CJS)](/platforms/javascript/guides/node/install/late-initialization/) +- [Lightweight Mode](/platforms/javascript/guides/node/install/lightweight/) +- [Set Up MCP Monitoring](/platforms/javascript/guides/node/mcp-monitoring/) +- [Configuration](/platforms/javascript/user-feedback/configuration/) +- [Set Up User Feedback](/platforms/javascript/user-feedback/) --- -### [docs(react-native): Document enableMetricKit option](https://github.com/getsentry/sentry-docs/pull/18881) - -**Added:** -- [MetricKit](/platforms/react-native/configuration/metric-kit/) +### [docs(js): Update data collection options](https://github.com/getsentry/sentry-docs/pull/19454) **Modified:** -- [App Hangs](/platforms/react-native/configuration/app-hangs/) -- [Options](/platforms/react-native/configuration/options/) +- [Options](/platforms/javascript/configuration/options/) +- [Data Collected](/platforms/javascript/data-management/data-collected/) --- -### [docs(android): Document search for ANR issues with profiles](https://github.com/getsentry/sentry-docs/pull/18970) +### [feat(docs): support default onboarding options](https://github.com/getsentry/sentry-docs/pull/19451) **Modified:** -- [Application Not Responding (ANR)](/platforms/android/configuration/app-not-respond/) +- [MDX Components](/contributing/pages/components/) +- [Eve](/platforms/javascript/guides/eve/) --- -### [docs(issues): Update issue categories to match sidebar taxonomy](https://github.com/getsentry/sentry-docs/pull/18965) +### [docs(unreal): User feedback attachments and local scope](https://github.com/getsentry/sentry-docs/pull/19442) **Modified:** -- [Issues](/product/issues/) +- [Scopes and Hubs](/platforms/unreal/enriching-events/scopes/) --- -## August 6, 2026 +## September 15, 2026 -### [docs(frontend): Document pending request tests](https://github.com/getsentry/sentry-docs/pull/18952) +### [ref(sentry.io): Mirror IP changes in ip-ranges.mdx](https://github.com/getsentry/sentry-docs/pull/19375) **Modified:** -- [Network Requests](https://develop.sentry.dev/frontend/network-requests/) +- [IP Ranges](/security-legal-pii/security/ip-ranges/) --- -### [docs(unreal): Automatic frame time metrics sampling change](https://github.com/getsentry/sentry-docs/pull/18961) +### [docs(develop-docs): add redis TTL guidance page](https://github.com/getsentry/sentry-docs/pull/19160) -**Modified:** -- [Set Up Metrics](/platforms/unreal/metrics/) +**Added:** +- [Redis](https://develop.sentry.dev/backend/application-domains/redis/) --- -### [docs(cloudflare): clarify Vite entry instrumentation](https://github.com/getsentry/sentry-docs/pull/18944) +### [docs(godot): Explain scope forking for active spans](https://github.com/getsentry/sentry-docs/pull/19382) **Modified:** -- [Vite Plugin](/platforms/javascript/guides/cloudflare/features/vite-plugin/) +- [Scopes](/platforms/godot/enriching-events/scopes/) +- [Instrumentation](/platforms/godot/tracing/instrumentation/) --- -### [docs(python): update integrations for stream mode](https://github.com/getsentry/sentry-docs/pull/18526) +### [docs(godot): Document distributed trace propagation](https://github.com/getsentry/sentry-docs/pull/19325) + +**Added:** +- [Custom Trace Propagation](/platforms/godot/tracing/distributed-tracing/custom-trace-propagation/) +- [Dealing with CORS Issues](/platforms/godot/tracing/distributed-tracing/dealing-with-cors-issues/) +- [Set Up Distributed Tracing](/platforms/godot/tracing/distributed-tracing/) +- [Limiting Trace Propagation](/platforms/godot/tracing/distributed-tracing/limiting-trace-propagation/) **Modified:** -- [AIOHTTP Client](/platforms/python/integrations/aiohttp/aiohttp-client/) -- [AIOHTTP](/platforms/python/integrations/aiohttp/) -- [aiomysql](/platforms/python/integrations/aiomysql/) -- [Anthropic](/platforms/python/integrations/anthropic/) -- [arq](/platforms/python/integrations/arq/) -- [ASGI](/platforms/python/integrations/asgi/) -- [asyncpg](/platforms/python/integrations/asyncpg/) -- [AWS Lambda Manual Instrumentation](/platforms/python/integrations/aws-lambda/manual-instrumentation/) -- [AWS Lambda Layer](/platforms/python/integrations/aws-lambda/manual-layer/) -- [Bottle](/platforms/python/integrations/bottle/) -- [Celery](/platforms/python/integrations/celery/) -- [clickhouse-driver](/platforms/python/integrations/clickhouse-driver/) -- [Django](/platforms/python/integrations/django/) -- [Falcon](/platforms/python/integrations/falcon/) -- [FastAPI](/platforms/python/integrations/fastapi/) -- [Flask](/platforms/python/integrations/flask/) -- [Google Cloud Functions](/platforms/python/integrations/gcp-functions/) -- [Google Gen AI](/platforms/python/integrations/google-genai/) -- [gRPC](/platforms/python/integrations/grpc/) -- [HTTPX](/platforms/python/integrations/httpx/) -- [HTTPX2](/platforms/python/integrations/httpx2/) -- [huey](/platforms/python/integrations/huey/) -- [Hugging Face Hub](/platforms/python/integrations/huggingface_hub/) -- [LangChain](/platforms/python/integrations/langchain/) -- [LangGraph](/platforms/python/integrations/langgraph/) -- [Litestar](/platforms/python/integrations/litestar/) -- [OpenAI](/platforms/python/integrations/openai/) -- [PyMongo](/platforms/python/integrations/pymongo/) -- [Pyramid](/platforms/python/integrations/pyramid/) -- [pyreqwest](/platforms/python/integrations/pyreqwest/) -- [Quart](/platforms/python/integrations/quart/) -- [Ray](/platforms/python/integrations/ray/) -- [Redis](/platforms/python/integrations/redis/) -- [RQ (Redis Queue)](/platforms/python/integrations/rq/) -- [Sanic](/platforms/python/integrations/sanic/) -- [Socket](/platforms/python/integrations/socket/) -- [SQLAlchemy](/platforms/python/integrations/sqlalchemy/) -- [Starlette](/platforms/python/integrations/starlette/) -- [Starlite](/platforms/python/integrations/starlite/) -- [Strawberry](/platforms/python/integrations/strawberry/) -- [Tornado](/platforms/python/integrations/tornado/) -- [WSGI](/platforms/python/integrations/wsgi/) +- [Options](/platforms/godot/configuration/options/) +- [Set Up Tracing](/platforms/godot/tracing/) +- [Instrumentation](/platforms/godot/tracing/instrumentation/) --- -### [docs(js): clarify OpenAI instrumentation for Cloudflare and tools](https://github.com/getsentry/sentry-docs/pull/18932) +### [docs(godot): Document tracing](https://github.com/getsentry/sentry-docs/pull/19210) + +**Added:** +- [Set Up Tracing](/platforms/godot/tracing/) +- [Instrumentation](/platforms/godot/tracing/instrumentation/) **Modified:** -- [OpenAI](/platforms/javascript/guides/node/configuration/integrations/openai/) +- [Options](/platforms/godot/configuration/options/) --- diff --git a/scripts/update-docs-changelog.mjs b/scripts/update-docs-changelog.mjs index de5194082af62..aebae60f820ac 100644 --- a/scripts/update-docs-changelog.mjs +++ b/scripts/update-docs-changelog.mjs @@ -285,6 +285,15 @@ function categorizeFiles(files) { continue; } + // Skip versioned doc files (e.g. index__v7.x.mdx). Their canonical URL is + // __v/, not /index__v7.x/, so the naive path-to-URL + // mapping below produces a 404 (caught by the lint-404 check). The current + // version of the page is almost always edited in the same PR and linked + // separately, so old-version pages add little to the changelog anyway. + if (file.filename.includes('__v')) { + continue; + } + // For non-removed files, only include if the file exists locally // This avoids linking to pages that haven't been deployed yet if (file.status !== 'removed') {