Skip to content

πŸ“– TechDocs assessment: read-only reference repos and starting the drafter - #18520

Merged
hivecommons-hive[bot] merged 1 commit into
v5from
docs/techdocs-readonly-refs-start-drafter
Nov 16, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
v5from
docs/techdocs-readonly-refs-start-drafter

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Docs-only update to src/docs/workflows/techdocs-assessment.md.

  • Read-only reference repos. The operator walkthrough used to assume the hive's GitHub App is installed on the reference repos ("because hivecommons has the App installed on every repo"). It now covers both cases. If this hive's App is only on cncf/techdocs, the derived entries read read-only, πŸ› Add graceful shutdown handler for 14 leaked setIntervalsΒ #395 gets one hive:reference-repos-read-only comment, and drafting still works because the drafter only reads those repos and the deliverable lands in cncf/techdocs. The issue, PR and branch actions in step 4 are marked write-tier only.
  • Accepted wears stage/020-claimed, but nothing has claimed it. This explains the label people see on accepted issues, and links πŸ› bug: labels added and removed multiple timesΒ #18434 / πŸ› Stop the in-progress sweep stripping workflow-model stage labelsΒ #18518.
  • New section "Starting the drafter (Accepted β†’ Draft)". It states plainly that nothing dispatches techdocs-drafter yet (the profiles exist only for the compiler's human-gate check). It then gives the exact steps a hive owner follows: check triage/accepted, then kick an agent from its dashboard card with a drafting prompt. The prompt asks for a draft PR labeled Docs analysis + phase/assessment, declares hive-open-pr --issues 395 and uses Refs #395. Finally it describes how the issue moves to draft-open, and the human gates that follow.
  • "Not representable today". Now lists the missing drafter and verifier dispatch.

πŸ€– Generated with Claude Code

… drafter

Describe the reference-repo credential state for a hive whose App is
only on cncf/techdocs (read-only until the owner grants access), note
that the Accepted state wears stage/020-claimed without a claim
(#18434), and document how a hive owner starts the drafter by hand
since nothing dispatches the techdocs-drafter profile yet.

Signed-off-by: Andy Anderson <andy@clubanderson.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Nov 16, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Nov 16, 2026
@hivecommons-hive
hivecommons-hive Bot merged commit ed5e894 into v5 Nov 16, 2026
87 of 91 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the docs/techdocs-readonly-refs-start-drafter branch November 16, 2026 21:50
@hivecommons-hive

Copy link
Copy Markdown
Contributor

Hive status β€” updated in place; edits do not notify. Full history is in the Activity Monitor.

Evidence bundle `#18520bcc0d7f` sha256:2c31ae05e8dd78f5fe7635ab67ad0ecf370967f90f8e6e08f5f04de6dae8f6dd β€” download from the dashboard or `hivectl review evidence #18520`.

@hivecommons-hive

Copy link
Copy Markdown
Contributor

merged by Hive trusted-author auto-merge: author @clubanderson holds role owner and GitHub permission admin on repo; CI green at bcc0d7f.

@clubanderson clubanderson added lgtm Indicates that a PR is ready to be merged. approved Indicates a PR has been approved by an approver from all required OWNERS files. labels Nov 16, 2026
@clubanderson

Copy link
Copy Markdown
Member Author

@nate-double-u FYI, this documents why cncf/techdocs#395 showed as claimed with no work yet, and how drafting gets started.

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

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. dco-signoff: yes Indicates the PR's author has signed the DCO. lgtm Indicates that a PR is ready to be merged. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant