Amend MIL-005: publish the wiki from wiki/ through a workflow #40

Merged
Tirsvad merged 2 commits from mil-005-wiki-publishing into main 2026-10-10 02:48:24 +02:00
Owner

Records the decision on how the wiki is published and amends MIL-005 accordingly.

Decision (MIL-005 task 2, issue #33)

  • The wiki page source lives in wiki/ in this repository and is reviewed through pull requests.
  • A workflow publishes wiki/ to github-action.wiki.git on merge to main.
  • The agent edits wiki/ on a branch and opens a PR; it never pushes to the wiki repository.
  • The publish secret can write to the wiki repository only; S05 approves it and S03 stores it.
  • Edits made in the Gitea web UI are overwritten on the next publish.

Changes to MIL-005

  • Deliverable: names wiki/, the publishing workflow and the PR rule.
  • Task 2 records the decision; task 3 builds the English pages into wiki/.
  • New task 8: add the wiki publishing workflow.
  • New Go/No-Go criterion 6: the wiki is published only by the workflow.
  • New Proposed version row; MIL-005 needs a re-review and a Go before it is Accepted again.

Not done yet

  • Issue #33 and the new task 8 are not updated on Gitea; that needs sync-project.sh --milestone MIL-005 --apply after the merge.
  • The RC-010 action item for this decision is closed by a new review record, not by editing RC-010.

No issue closed: this amends the plan only.

Records the decision on how the wiki is published and amends MIL-005 accordingly. ## Decision (MIL-005 task 2, issue #33) - The wiki page source lives in `wiki/` in this repository and is reviewed through pull requests. - A workflow publishes `wiki/` to `github-action.wiki.git` on merge to `main`. - The agent edits `wiki/` on a branch and opens a PR; it never pushes to the wiki repository. - The publish secret can write to the wiki repository only; S05 approves it and S03 stores it. - Edits made in the Gitea web UI are overwritten on the next publish. ## Changes to MIL-005 - Deliverable: names `wiki/`, the publishing workflow and the PR rule. - Task 2 records the decision; task 3 builds the English pages into `wiki/`. - New task 8: add the wiki publishing workflow. - New Go/No-Go criterion 6: the wiki is published only by the workflow. - New `Proposed` version row; MIL-005 needs a re-review and a Go before it is `Accepted` again. ## Not done yet - Issue #33 and the new task 8 are not updated on Gitea; that needs `sync-project.sh --milestone MIL-005 --apply` after the merge. - The RC-010 action item for this decision is closed by a new review record, not by editing RC-010. No issue closed: this amends the plan only.
Tirsvad added 2 commits 2026-10-10 02:46:34 +02:00
Records the decision for task 2: the page source lives in this repository,
reaches the wiki repository only through a workflow, and the agent never
pushes to it. Adds task 8 for the publishing workflow and a Go/No-Go
criterion that no manual push exists.
Resolve pending commit link in MIL-005
Validate workflows / validate (pull_request) Successful in 15s
1114b742dc
Tirsvad merged commit 5a38842e4d into main 2026-10-10 02:48:24 +02:00
Sign in to join this conversation.