Skip to content

Comments

docs(develop-docs): group playbooks index into logical sections#16519

Merged
dingsdax merged 11 commits intomasterfrom
dev-docs/playbooks/grouping
Feb 24, 2026
Merged

docs(develop-docs): group playbooks index into logical sections#16519
dingsdax merged 11 commits intomasterfrom
dev-docs/playbooks/grouping

Conversation

@dingsdax
Copy link
Contributor

Replace flat PageGrid with manually grouped sections:

  • Setup & Onboarding
  • Day-to-Day Development
  • Cross-SDK Processes
  • SDK Lifecycle

DESCRIBE YOUR PR

Tell us what you're changing and why. If your PR resolves an issue, please link it so it closes automatically.

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

LEGAL BOILERPLATE

Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.

EXTRA RESOURCES

Replace flat PageGrid with manually grouped sections:
- Setup & Onboarding
- Day-to-Day Development
- Cross-SDK Processes
- SDK Lifecycle

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Feb 23, 2026

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

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Feb 24, 2026 11:51am
sentry-docs Ready Ready Preview, Comment Feb 24, 2026 11:51am

Request Review

Reorganize the flat playbooks list into four subfolders so the sidebar
reflects the same grouping:

- setup/          — Setup & Onboarding
- development/    — Day-to-Day Development
- coordination/   — Cross-SDK Processes
- sdk-lifecycle/  — SDK Lifecycle

Update all cross-references in playbooks and standards to match the
new URL structure.

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link
Contributor

@stephanie-anderson stephanie-anderson left a comment

Choose a reason for hiding this comment

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

@dingsdax Pls add redirects, everything else seems fine!

Playbooks were reorganized into grouped subfolders (development/,
coordination/, sdk-lifecycle/, setup/). Add redirects from the old
flat URLs to the new paths so existing links don't break.

Co-Authored-By: Claude <noreply@anthropic.com>
The anchor link https://github.com/getsentry/sdk-skills#available-skills
cannot be resolved by lychee (GitHub anchor fragments require JavaScript
rendering). Add it to .lycheeignore to prevent false failures.

Co-Authored-By: Claude <noreply@anthropic.com>
The previous pattern only matched fragment-only URLs (#...) but the
actual link uses ?tab=readme-ov-file#available-skills. Widen the
pattern to cover all URLs for the private sdk-skills repo.

Co-Authored-By: Claude <noreply@anthropic.com>
Two pre-existing redirects pointed to intermediate paths that this PR
also redirects, creating double-hops. Update their destinations directly
to the new grouped paths:

- /sdk/processes/releases/ → .../setup/setting-up-release-infrastructure/
- /sdk/miscellaneous/feature-branches/ → .../development/syncing-feature-branches/

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link

@cursor cursor bot left a comment

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.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

The previous pattern only matched https:// but not http://, leaving
the http variant uncovered. Use https?:// to be consistent with all
other entries in .lycheeignore.

Co-Authored-By: Claude <noreply@anthropic.com>
@dingsdax dingsdax merged commit de67488 into master Feb 24, 2026
19 checks passed
@dingsdax dingsdax deleted the dev-docs/playbooks/grouping branch February 24, 2026 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants