Skip to content

docs(agent-tracing): Normalize GenAI developer conventions - #19465

Closed
sentry-junior[bot] wants to merge 8 commits into
masterfrom
ognjenbostjancic/tet-2938-normalize-genai-developer-conventions
Closed

sentry-junior[bot] wants to merge 8 commits into
masterfrom
ognjenbostjancic/tet-2938-normalize-genai-developer-conventions

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Moves the developer conventions portion of #19459 into a separate PR so the 404 workflow does not build both docs sites in the same job.

Normalizes current GenAI attribute names, clarifies message part shapes, and fixes cached and reasoning token subset references in the AI Agents module.

Part of TET-2938.

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • 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

via Ogi.

--

View Junior Session [Sentry]

Co-Authored-By: Ognjen Bostjancic <ognjen.bostjancic@sentry.io>
@vercel

vercel Bot commented Sep 17, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
develop-docs Ready Ready Preview Sep 17, 2026 3:06pm UTC
sentry-docs Ready Ready Preview Sep 17, 2026 3:06pm UTC

Request Review

@github-actions github-actions Bot added the sdk-develop-docs PRs touching develop-docs/sdk label Sep 17, 2026
@linear-code

linear-code Bot commented Sep 17, 2026

Copy link
Copy Markdown

TET-2938

…ic/tet-2938-normalize-genai-developer-conventions
Comment thread .github/workflows/lint-404s.yml Outdated

@cursor cursor Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 4285b1e. Configure here.

Comment thread .github/workflows/lint-404s.yml Outdated
Comment thread .github/workflows/lint-404s.yml Outdated
@sentry-junior

sentry-junior Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor Author

Closing as superseded. Everything in this PR has either landed or moved:

Thanks for the review, @vgrozdanic. #19830 keeps the same cleanup behavior you approved here.

@sentry-junior sentry-junior Bot closed this Oct 6, 2026
sfanahata added a commit that referenced this pull request Oct 8, 2026
## DESCRIBE YOUR PR

`pnpm build` and `pnpm build:developer-docs` both write to `.next`. When
a PR touches both `docs/**` and `develop-docs/**`, the 404 workflow runs
both builds in one job and then starts one server. By then the developer
docs build has overwritten the docs build, so only developer docs get
checked for broken links.

This change gives each changed site its own job and runner:

- A `changes` job decides which sites changed.
- One `Lint <site> for 404s` job runs per changed site, in parallel.
Each job builds, starts the server, and runs the linter. The runner is
thrown away when the job ends, so the server doesn't need to be stopped
and nothing else shares port 3000.
- A small `lint-404` job keeps the required check name. It passes when
every changed site passes its lint, or when no site changed.

Changes to this workflow or `scripts/lint-404s/**` now lint both sites,
so edits to the workflow check themselves.

An earlier version of this PR handled the shared build with a bash
script that started and stopped the server between sites. Separate jobs
remove the need for it. PRs that touch both sites also run the two
builds in parallel instead of one after the other.

Replaces #19465. That PR's other changes already landed in #19509 (AI
Agents doc) and #19526 (cross-site link handling).

## IS YOUR CHANGE URGENT?

- [ ] Urgent deadline (GA date, etc.): YYYY-MM-DD
- [ ] Other deadline: YYYY-MM-DD
- [x] No deadline: Not urgent, can wait up to 1 week+

## PRE-MERGE CHECKLIST

- [ ] 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)

<!-- junior-request-attribution:start -->
via **shannon.anahata**.
<!-- junior-request-attribution:end -->

<!-- junior-session-footer:start -->
<!-- junior-conversation-id:slack%3AD0BB8KQT6MU%3A1791324850.904489 -->

--

[View Junior
Session](https://junior-prod.sentry.dev/conversations/slack%3AD0BB8KQT6MU%3A1791324850.904489)
[[Sentry]](https://sentry.sentry.io/explore/conversations/slack%3AD0BB8KQT6MU%3A1791324850.904489/?project=4510944073809921)

<!-- junior-session-footer:end -->

---------

Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
Co-authored-by: Shannon Anahata <shannon.anahata@sentry.io>

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — b78d3a7f Deployed Sep 17, 2026 by vercel[bot]
Preview – develop-docs — b78d3a7f Deployed Sep 17, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline sdk-develop-docs PRs touching develop-docs/sdk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants