Skip to content

Add Linear Releases setup guide#109859

Draft
robertbpugh wants to merge 3 commits intotrunkfrom
docs/linear-releases
Draft

Add Linear Releases setup guide#109859
robertbpugh wants to merge 3 commits intotrunkfrom
docs/linear-releases

Conversation

@robertbpugh
Copy link
Copy Markdown
Contributor

Part of #109467

Proposed Changes

  • Adds docs/linear-releases.md capturing setup instructions and pilot findings from the Creators team rollout.

Why are these changes being made?

Follow-up to the Creators Linear Release workflow PR. The pilot surfaced several gotchas (keyword prefix requirements, fetch-depth, action versioning confusion, SHA pinning) that every adopting team will hit. This doc saves them the archaeology.

Testing Instructions

  • Documentation only, no code changes.

Pre-merge Checklist

  • Has the general commit checklist been followed? (PCYsg-hS-p2)
  • Have you written new tests for your changes?
  • Have you tested the feature in Simple (P9HQHe-k8-p2), Atomic (P9HQHe-jW-p2), and self-hosted Jetpack sites (PCYsg-g6b-p2)?
  • Have you checked for TypeScript, React or other console errors?
  • Have you tested accessibility for your changes?
  • Have you used memoizing on expensive computations?
  • Have we added the "[Status] String Freeze" label as soon as any new strings were ready for translation (p4TIVU-5Jq-p2)?
  • For changes affecting Jetpack: Have we added the "[Status] Needs Privacy Updates" label if this pull request changes what data or activity we track or use (p4TIVU-aUh-p2)?

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

Captures pilot findings from the Creators team rollout so the next
team adopting Linear Releases does not have to rediscover gotchas
(keyword prefixes, fetch-depth, action versioning, SHA pinning).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…dd beta note

- Pipeline access key, not Personal API key
- Keyword prefix finding is observed behavior from pilot (v0.5.0), not definitive
- Linear Releases is in public beta
- Release creation is conditional on matching commits

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The Release CLI detects issues via PR references in squash merge commits,
not just commit message keywords. Keyword prefixes are only needed for
commits without an associated PR. Confirmed by Linear engineer in Slack.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

1 participant