Skip to content

[Governance] Add lightweight governance revision log process #423

Closed

Description

@ashleyshaw

Summary

Add a lightweight governance/process change-tracking mechanism so policy changes are auditable without heavy overhead.

Scope

  • Define the minimal revision-log format (date, change summary, rationale, issue/PR links).
  • Add a governance revision log file under docs/.
  • Document when entries are required.

Acceptance Criteria

  • Governance revision log process is documented.
  • Owners/review cadence is clear.
  • Guidance is linked from CONTRIBUTING.md or governance docs.

Parent

Activity

  1. linear-code commented on May 27, 2026

    @linear-code
  2. self-assigned this
    on May 27, 2026
  3. ashleyshaw commented on May 27, 2026

    @ashleyshaw
    MemberAuthor

    Triage complete: moved to status:ready and assigned to @ashleyshaw.\n\nDependency order agreed for execution: #422 -> #423 -> #424.\n- #422 defines canonical reference policy first (single source of truth + examples).\n- #423 implements the governance revision log process based on #422 policy.\n- #424 performs stale-link/path sweep after #422/#423 wording lands.

  4. added this to the milestone on May 27, 2026
  5. ashleyshaw commented on May 27, 2026

    @ashleyshaw
    MemberAuthor

    Completed in #440.\n\nDelivered:\n- new lightweight governance revision log at docs/GOVERNANCE_REVISION_LOG.md\n- minimal required entry format (date, summary, rationale, links)\n- explicit rules for when entries are required\n- owner and review cadence definition\n- cross-links from CONTRIBUTING.md and docs/AUTOMATION_GOVERNANCE.md\n\nValidation run:\n- markdownlint on changed docs passed\n- local relative-link checks passed\n- git diff --check passed

  6. ashleyshaw commented on May 27, 2026

    @ashleyshaw
    MemberAuthor

    Follow-up closeout after merge of #439:\n\n- #422 is now merged/closed and the canonical instruction reference policy is in place.\n- #423 remains the next dependent task (governance revision log process) and is unblocked by policy clarity.\n\nStatus: keep open and proceed as next execution step in the milestone sequence.

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

Metadata

Metadata

Assignees

Type

No type

Fields

Priority

None yet

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions