Skip to content

docs: clarify package update PR policy#10992

Merged
jasonsaayman merged 1 commit into
v1.xfrom
docs/package-actions-update-policy
Jun 5, 2026
Merged

docs: clarify package update PR policy#10992
jasonsaayman merged 1 commit into
v1.xfrom
docs/package-actions-update-policy

Conversation

@jasonsaayman

@jasonsaayman jasonsaayman commented Jun 5, 2026

Copy link
Copy Markdown
Member

Summary

Updates all the docs which need to be updated to reinforce our policy about package changes and updates.

Linked issue

N/A

Changes

See above

Checklist

  • Tests added or updated (or N/A with reason)
  • Docs/types updated if public API changed (index.d.ts and index.d.cts)
  • No breaking changes (or called out explicitly above)

Summary by cubic

Clarifies and codifies that package, lockfile, and GitHub Actions version update PRs are maintainer/bot-only, with a 7‑day Dependabot delay unless a critical vulnerability requires a maintainer-led manual update. Updates contributor docs, templates, and config comments to reduce noisy or risky update PRs.

Description

  • Summary of changes
    • Updated PR template, CONTRIBUTING.md, COLLABORATOR_GUIDE.md, AGENTS.md, and .github/copilot-instructions.md with the maintainer/bot-only policy and 7-day delay.
    • Added clarifying comments to .github/dependabot.yml.
    • Updated THREATMODEL.md mitigations to include the policy and note the cooldown exception.
  • Reasoning
    • Reduce supply-chain risk and review noise from unsolicited update PRs.
    • Make the standing policy explicit and consistent across docs and configs.
  • Additional context
    • No runtime or build logic changes. Documentation and comments only.

Docs

Suggest adding a short note under /docs/contributing about:

  • Maintainer/bot-only package, lockfile, and GitHub Actions update PRs.
  • The 7-day Dependabot delay and the critical-vuln exception.

Testing

No tests added or changed. None needed for docs-only updates.

Semantic version impact

No version impact. Docs-only; no release required.

Written for commit c665288. Summary will update on new commits.

Review in cubic

@jasonsaayman jasonsaayman self-assigned this Jun 5, 2026
@jasonsaayman jasonsaayman added priority::medium commit::docs The PR is related to docs labels Jun 5, 2026

@cubic-dev-ai cubic-dev-ai 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.

No issues found across 7 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Re-trigger cubic

@jasonsaayman jasonsaayman force-pushed the docs/package-actions-update-policy branch from 12c0db9 to c665288 Compare June 5, 2026 06:03
@jasonsaayman jasonsaayman merged commit fae9d4e into v1.x Jun 5, 2026
27 checks passed
@jasonsaayman jasonsaayman deleted the docs/package-actions-update-policy branch June 5, 2026 06:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

commit::docs The PR is related to docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant