Skip to content

Add the managed documentation-update process #163

Description

@lastobelus

Target

Implement this ticket in lastobelus/lastCode after the docs capture and validation commands exist.

Acceptance

  • Run the docs update as a sibling of the checkpoint process. A docs failure must not block or roll back a checkpoint, build, or promotion.
  • Use one guarded docs checkout, one durable docs thread, one fixed branch, and one open pull request.
  • Send the exact LastCode commit range, affected feature IDs, and bounded changed paths to the docs thread.
  • Coalesce a change that arrives during active work into a later turn.
  • Verify the pull-request branch freshness record before reporting completion.
  • Keep only active request, wait correlation, and incident-delivery data locally.
  • Test a no-op range, a relevant range, an overlapping arrival, an agent failure, and a docs-validation failure.
  • Commit no machine names, checkout paths, thread IDs, schedules, or private endpoints.

Only one machine runs this process. Start with one owner and one pending-update slot. If implementation or PR review keeps finding coordination bugs, remove automatic overlap handling or serialize the step before adding locks, queues, leases, or distributed state.

Activity

  1. lastobelus commented on Oct 6, 2026

    @lastobelus
    OwnerAuthor

    The research and implementation backlog are being preserved before the documentation-site conversation is archived. This updater remains unimplemented.

    Carry forward the agreed small process: no-op ranges do not create freshness-only PRs; relevant changes review affected evidence and rerun enabled automated recipes; documentation failures report separately and never block or roll back LastCode. Preserve the packed-history warning and public repository boundary. Concrete deployment wiring stays outside public repositories.

    When review repeatedly exposes races or edge cases, remove state or make a step manual before adding coordination machinery. The maintainer currently defers manual media under #161.

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

    documentationImprovements or additions to documentation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions