Skip to content

STATUS

Jump to bottom
Azahari Zaman edited this page Jun 27, 2026 · 1 revision

Wiki bootstrap — current status

As of 2026-06-27 18:30 UTC+8

What's done

  • 29 wiki pages prepared, 1-to-1 from the files deleted in the post-v1 springclean.
  • Pages are organized under an "Internal Development" parent per the dry-run plan.
  • All content is committed in this local git repo (/tmp/paxman-wiki).
  • A bootstrap script (push-wiki.sh) is ready to push everything once the wiki git repo exists on GitHub.

What's blocked

The nexusnv/paxman.wiki.git repo does not exist on GitHub yet.

GitHub creates wiki repos lazily, on the first user visit to the wiki tab in the web UI. There is no API, CLI, or git-push path that creates it. The has_wiki: true flag in the repo settings is set (you can verify with gh api repos/nexusnv/paxman | grep has_wiki), but the git repo itself is not materialized.

What the user needs to do (30 seconds)

  1. Open https://github.com/nexusnv/paxman/wiki in a browser, signed in as the maintainer.
  2. The page will say "Create the first page" or "Wiki is empty." Click any button to trigger the lazy creation.
  3. Tell me the wiki is up, OR just re-run the push script.

What happens next (5 seconds)

The maintainer (or Sisyphus on instruction) runs:

bash /tmp/paxman-wiki/push-wiki.sh

This force-pushes the prepared commit to the freshly-materialized wiki repo. The 29 pages appear in seconds. The wiki is then maintained via normal git push to https://github.com/nexusnv/paxman.wiki.git.

Why this is not a blocker for the springclean PR

The PR (https://github.com/nexusnv/paxman/pull/27) is independent of the wiki. It deletes the files from the repo and updates cross-references in the source code to point at the wiki URL pattern. The wiki URLs are correct whether or not the wiki has been populated yet — they're just URLs. The wiki is a separate repo, populated separately.

The springclean is correct and complete. The wiki population is a follow-up that requires one human click + one bash command.

File map

Path What it is
Home.md Wiki landing page
Internal-Development.md Parent page for the "Internal Development" section
Internal-Development/Release-Roadmap.md Index of all V1 sprints
Internal-Development/Sprints/Sprint-NN---Title.md (×12) Per-sprint plans (Sprint 0 through Sprint 10, plus Sprint 7a)
Internal-Development/Reports/*.md (×6) Bandit, pip-audit, OIDC, performance baseline, cross-platform verification, sprint delivery audit
Internal-Development/Decision-History/*.md (×7) PRD, V1 acceptance criteria, license decision analysis, CHANGES_LOG, sprint plan, retrospective, investor pitch
Internal-Development/Old-Releases/v0.5.0-release-notes.md Pre-V1 history
push-wiki.sh The bootstrap script
STATUS.md This file

Total: 29 markdown files, 5,227 lines of content.

Clone this wiki locally