Skip to content

docs(security): document temporary-fork CI and publication gates #569

Description

@ss-o

Problem

The security incident runbook recommends GitHub temporary private forks but does not document a material platform constraint: integrations cannot access those forks and status checks do not run on their pull requests.

That omission leaves the response procedure ambiguous when normal policy requires exact CI evidence, public documentation updates, or parent-workspace gitlinks. A maintainer can otherwise either disclose the remediation through a public branch too early or wait for CI that GitHub will never start.

Proposed update

  • state the temporary-private-fork integration and status-check limitation
  • require equivalent local validation evidence on the exact private head
  • allow a separate public CI-only pull request only when its diff contains no vulnerability or remediation detail
  • keep disclosure-bearing documentation and parent gitlinks unpublished until the private remediation is merged
  • define the authority sequence for advisory merge, patched release when applicable, advisory publication, public documentation, and gitlink reconciliation
  • record the unavailable-CI exception and exact local evidence in the draft advisory

Acceptance criteria

  • runbooks/security-incident-response.md describes the full private-fork publication sequence without duplicating GitHub documentation
  • the procedure preserves the existing rule against public exploit details
  • merge, release, advisory publication, and unrelated repository publication remain separately authorized actions
  • links point to GitHub's current temporary-private-fork documentation

Reference: https://docs.github.com/code-security/security-advisories/working-with-repository-security-advisories/collaborating-in-a-temporary-private-fork-to-resolve-a-repository-security-vulnerability

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:docsDocumentation systems, content, or publishing.securitySecurity-sensitive issue or hardening work.type:docsDocumentation-only work.

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions